How aekam27/miwl2 works
Miwl 2 is a local desktop workspace for writing sessions, source documents, and editable drafts, with optional voice, camera/face-matching, and cloud-text capabilities. The main workflow runs from the user through the desktop entry point and workspace bridge into a job service, which uses a configured provider and persists session results. Separate branches support document import and retrieval, voice transcription/playback, and camera/gallery/vision workflows. Relationships are based on excerpts, the SOURCE INDEX, and README statements; several subsystem internals were not sampled, so their links are limited to documented or indexed relationships.
Main entry points: app.py Desktop app · service.py Job service · vision_ui.py Vision controls · configuration.py Provider configuration
Components 21
Desktop workspace
- Desktop app
src/miwl2/app.py - Writing bridge
src/miwl2/bridge.py - Camera controls
src/miwl2/camera_ui.py - Document controls
src/miwl2/documents_ui.py - Voice controls
src/miwl2/voice_ui.py - Vision controls
src/miwl2/vision_ui.py
Writing workflow
- Job service
src/miwl2/service.py - Writing requests
src/miwl2/domain.py
Source documents
- Import and search
src/miwl2/documents.py
Voice and vision
- Camera streams
src/miwl2/cameras.py - Transcription and speech
src/miwl2/voice.py - Face matching
src/miwl2/vision.py - Encrypted gallery
src/miwl2/gallery.py
Providers and persistence
- Provider configuration
src/miwl2/configuration.py - Fixture provider
src/miwl2/providers.py - Ollama adapter
src/miwl2/ollama.py - OpenAI adapter
src/miwl2/cloud.py - Writing store
src/miwl2/storage.py
Other components
- Writer
- Local Ollama
- OpenAI API
Connections 25
- Writer → Desktop app: opens workspace
README.md - Desktop app → Job service: creates service
src/miwl2/app.py - Desktop app → Writing bridge: installs bridge
src/miwl2/app.py - Desktop app → Camera controls: installs controls
src/miwl2/app.py - Desktop app → Document controls: installs controls
src/miwl2/app.py - Desktop app → Voice controls: installs controls
src/miwl2/app.py - Desktop app → Vision controls: installs controls
src/miwl2/app.py - Writing bridge → Job service: starts jobs
src/miwl2/bridge.py - Job service → Writing store: persists jobs
src/miwl2/service.py - Job service → Writing requests: builds requests
src/miwl2/service.py - Job service → Provider configuration: configures provider
src/miwl2/service.py - Provider configuration → Fixture provider: builds adapter
src/miwl2/configuration.py - Provider configuration → Ollama adapter: builds adapter
src/miwl2/configuration.py - Provider configuration → OpenAI adapter: builds adapter
src/miwl2/configuration.py - Ollama adapter → Local Ollama: sends requests
README.md - OpenAI adapter → OpenAI API: sends requests
README.md - Document controls → Import and search: imports and searches
src/miwl2/documents_ui.py - Document controls → Writing bridge: uses workspace
src/miwl2/documents_ui.py - Camera controls → Camera streams: controls streams
src/miwl2/camera_ui.py - Voice controls → Transcription and speech: controls voice
src/miwl2/voice_ui.py - Vision controls → Camera controls: uses camera controls
src/miwl2/vision_ui.py - Vision controls → Face matching: runs matching
src/miwl2/vision_ui.py - Vision controls → Encrypted gallery: manages enrollments
src/miwl2/vision_ui.py - Face matching → Encrypted gallery: reads profiles
src/miwl2/vision.py - Camera streams → Writing store: saves settings
src/miwl2/cameras.py