# Module **Revision:** r2 **Source:** CLAUDE.md, Code-Analyse **Last updated:** 2026-04-10 14:00 --- ## Verzeichnisstruktur ``` trixy7/source/ ├── main.py # CLI-Einstiegspunkt ├── config/ # JSON-Konfigurationsdateien ├── trixy_core/ # Kernframework ├── plugins/ # Benutzer-Plugins ├── models/ # ML-Modelle (wakeword/, voice_recognition/, intent/) ├── trainer/ # Trainingsdaten (data/raw/) ├── assets/ # Audio-Dateien, Profile ├── satellites/ # Registrierte Satellite-JSON ├── certs/ # SSL-Zertifikate ├── logs/ # Anwendungslogs └── make_installer/ # Installer-TUI ``` ## trixy_core Module ### trixy_core.utils **Zweck:** Hilfsfunktionen und Konstanten | Datei | Inhalt | |-------|--------| | `debug.py` | `pinfo()`, `pdebug()`, `perror()`, `pwarn()` — Farbcodierte Ausgabe | | `version.py` | VERSION, PROTOCOL_VERSION Konstanten | ### trixy_core.service **Zweck:** Service-Container und Lebenszyklus-Management | Datei | Inhalt | |-------|--------| | `enums.py` | ServicePriority, ServiceGroup, ServiceState | | `iservice.py` | IService abstrakte Basisklasse | | `service_container.py` | ServiceContainer mit Abhaengigkeitsaufloesung | ### trixy_core.events **Zweck:** Event-System (Pub/Sub) | Datei | Inhalt | |-------|--------| | `enums.py` | EventPriority | | `decorators.py` | @TrixyEvent, @event_handler | | `eventmanager.py` | EventManager | | `event_data/base.py` | EventData Basisklasse | | `event_data/basic.py` | SatelliteConnected, WakewordReceived, etc. | ### trixy_core.config **Zweck:** Konfigurationsmanagement mit Typisierung | Datei | Inhalt | |-------|--------| | `config_manager.py` | ConfigManager mit File-Watching | | `datasets/server.py` | ServerConfig Dataclass | | `datasets/client.py` | ClientConfig Dataclass | | `datasets/standalone.py` | StandaloneConfig Dataclass | | `datasets/trainer.py` | TrainerConfig Dataclass | ### trixy_core.network **Zweck:** Netzwerkprotokoll und Verschluesselung | Datei | Inhalt | |-------|--------| | `protocol.py` | TrixyProtocol, ProtocolFlags | | `encryption.py` | TrixyEncryption (AES-256-GCM) | | `client_connection.py` | Client-seitige Verbindungsverwaltung | | `config_listener.py` | ConfigListener (IService, Port 2105) | | `cmd/base.py` | CommandMessage Basisklasse | | `cmd/satellite.py` | SatelliteConnect, SatelliteAccepted, etc. | | `cmd/wakeword.py` | WakewordDetected, WakewordSelected, etc. | | `cmd/recording.py` | RecordingStart, RecordingStop, etc. | | `cmd/system.py` | SystemReboot, SystemStatus, etc. | | `cmd/config_cmd.py` | ConfigConnect, ConfigStatusRequest, ConfigSatelliteAudioRequest, etc. | ### trixy_core.satellite **Zweck:** Satellite-Verwaltung und Registrierung | Datei | Inhalt | |-------|--------| | `satellite.py` | Satellite Klasse, ConnectionState | | `satellite_manager.py` | SatelliteManager (Registry) | | `registration_manager.py` | RegistrationManager (60s Timeout) | ### trixy_core.audio **Zweck:** Audio-Ein-/Ausgabe, Lautstaerke, Multi-Device | Datei | Inhalt | |-------|--------| | `volume.py` | `_MixerChannel` — ALSA Lautstaerke-Steuerung | | `pulse_combined.py` | `PulseSink` — Multi-Speaker Combined-Sink | | `pulse_mic_mix.py` | `PulseSource` — Multi-Mic null-sink + loopback Mix | | `microphone.py` | Mikrofon-Eingabe | | `player.py` | Audio-Ausgabe | | `accumulator.py` | Audio-Puffer | | `stt.py` | Speech-to-Text Integration | | `tts.py` | Text-to-Speech Integration | | `processing/` | Audio-Pipeline mit Pipeline, Processor, Context | ### trixy_core.tui **Zweck:** Textual-basiertes TUI-Framework fuer Server und Config-Tool | Datei | Inhalt | |-------|--------| | `app.py` | `TrixyTUI` — Haupt-TUI mit F-Key Navigation | | `menu_context.py` | MenuContext — View-Routing und Keybindings | | `views/base.py` | MainView Basisklasse | | `views/health_view.py` | OS-Metriken (RAM, CPU, Disk, Netzwerk, Uptime) | | `views/satellites_view.py` | Satellite-Liste mit Status, Register/Delete | | `views/sat_audio_view.py` | Per-Satellite Audio-Steuerung (F6) | | `views/config_view.py` | System-Config Editor | | `views/trainer_view.py` | Trainer-Liste (F7) | | `views/trainer_*.py` | Trainer Sub-Views (Info/Settings/Dataset/Optional/Validate) | | `widgets/` | StatusTable, ProgressDialog, Header, Footer, LossChart | ### trixy_core.trainer **Zweck:** ML-Training Framework (ADR-008) | Datei | Inhalt | |-------|--------| | `itrainer.py` | ITrainer ABC — get_info(), train(), validate() | | `registry.py` | TrainerRegistry — Discovery von Core- und Plugin-Trainern | | `service.py` | TrainerService (IService) — multiprocessing.Process | | `dataclasses.py` | TrainerInfo, TrainingProgress, ValidationResult, FormSchema | | `application.py` | TrainerApplication — Standalone CLI-Training | | `core/wakeword_trainer.py` | WakewordTrainer — OpenWakeWord LogisticRegression | | `core/intent/trainer.py` | IntentTrainer — Sentence-Transformers + ONNX Export | | `core/intent/data_generator.py` | Intent-Daten aus Plugin-YAML Dateien | | `core/intent/embedding_cache.py` | Embedding-Cache fuer schnelleres Training | | `core/intent/slot_lists.py` | Slot-Listen fuer Intent-Slots | | `core/intent/bio_tagger.py` | BIO-Slot-Tagger Kopf | | `core/tts_engines/` | ITTSEngine + 8 Implementierungen (Piper, gTTS, Edge, ...) | ### trixy_core.plugins **Zweck:** Plugin-System | Datei | Inhalt | |-------|--------| | `trixy_plugin.py` | TrixyPlugin Basisklasse | | `plugin_manager.py` | PluginManager (Laden, Enable/Disable) | ### trixy_core.config_app **Zweck:** Remote Config-Tool (eigenstaendige Textual-App) - `ConfigApplication` — Verbindet sich via Port 2105 zum Server - Unterstuetzt: Status, Config-Aenderungen, Satellite-Audio, Geraete-Liste - Erbt NICHT von IApplication — Textual hat eigenen Event-Loop ### Anwendungsklassen | Datei | Klasse | Zweck | |-------|--------|-------| | `application.py` | IApplication | Abstrakte Basis | | `server.py` | ServerApplication | Server-Modus | | `client.py` | ClientApplication | Client/Satellite-Modus | | `standalone.py` | StandaloneApplication | Standalone-Modus | --- **See also:** [architecture.md](architecture.md), [apis.md](apis.md)