How alndaly/mosael works
Mosael is a desktop AI video studio. Its main creative loop gathers project references, plans on boards or in 3D, generates media, edits picture and sound, then publishes through a desktop browser executor. The map also preserves agents, reusable workflows, plugins, and the Chrome companion as distinct capabilities. README descriptions support the product-level links; sampled source confirms workflow scheduling, backend startup, and reference preview behavior, but does not establish every route-to-domain call, so uncertain internal wiring is omitted.
Main entry points: routes Feature routes · agent Workspace agents · engine.py Workflow engine · main.py HTTP API
Components 22
Desktop workspace
- Desktop shell
electron/main.cjs - Studio interface
frontend/src/api/client.ts - Chrome companion
browser-extension/src/sidepanel.tsx
Creative planning
- Notes and documents
backend/app/domain/documents - Creative boards
backend/app/domain/boards - 3D scenes
backend/app/domain/scenes
Media production
- Media library
backend/app/media - Timeline editing
backend/app/domain/sequences - Media generation
backend/app/domain/generation/runner.py - AI providers
backend/app/ai/providers/registry.py - Voice and transcription
backend/app/domain/voices
AI and automation
- Workspace agents
backend/app/domain/agent - Workflow engine
backend/app/domain/workflows/engine.py - Plugin capabilities
backend/app/domain/plugins - Scheduled runs
backend/app/domain/scheduler - Publishing executor
electron/publish/publishWorker.ts
Runtime platform
- HTTP API
backend/app/main.py - Feature routes
backend/app/api/routes - Project database
backend/app/core/db.py
Other components
- Creator
- Model services
- Video platforms
Connections 28
- Creator → Studio interface: creates and edits
- Desktop shell → HTTP API: starts backend
- Studio interface → HTTP API: requests features
- Chrome companion → HTTP API: imports media
- HTTP API → Feature routes: dispatches requests
- Feature routes → Project database: reads and writes
- Feature routes → Notes and documents: handles documents
- Feature routes → Creative boards: handles boards
- Feature routes → 3D scenes: handles scenes
- Feature routes → Media library: handles assets
- Feature routes → Timeline editing: handles editing
- Feature routes → Media generation: starts generation
- Feature routes → Voice and transcription: handles audio
- Feature routes → Workspace agents: dispatches agent work
- Feature routes → Workflow engine: runs workflows
- Media generation → AI providers: selects provider
- AI providers → Model services: sends model requests
- Workspace agents → Creative boards: uses workspace tools
- Workspace agents → Notes and documents: uses workspace tools
- Workspace agents → 3D scenes: uses workspace tools
- Workspace agents → Plugin capabilities: invokes tools
- Workflow engine → Plugin capabilities: runs plugin nodes
- Scheduled runs → Workflow engine: starts scheduled runs
- Workflow engine → Media generation: executes generation nodes
- Workflow engine → Media library: uses media inputs
- Timeline editing → Media library: uses media assets
- Publishing executor → Video platforms: submits posts
- Studio interface → Publishing executor: reviews and submits