How andrew-babo/muse4ai works
Muse4AI is a Windows desktop bridge that lets a person use Muse interactively or let an external agent submit and manage image, video, chat, and extension jobs through a local API. The API server routes REST/MCP and OAuth requests into job services; the coordinator manages execution, while the repository and database retain jobs and assets. The desktop renderer provides the local control surface. The README also documents a shared bilingual guide, agent instructions, and use-case content. Some execution and storage wiring is only partly sampled, so uncertain links are omitted or marked unverified.
Main entry points: coordinator.ts Job coordinator · repo.ts Domain repository · service.ts Job API service · ipcHandlers.ts IPC handlers
Components 23
Desktop app
- Desktop UI
desktop/src/renderer/App.tsx - Main process
desktop/src/main/main.ts - IPC handlers
desktop/src/main/ipcHandlers.ts
Agent API
- API server
desktop/src/main/api/server.ts - API controller
desktop/src/main/api/controller.ts - Job API service
desktop/src/main/api/service.ts - OAuth routes
desktop/src/main/api/oauth/http.ts - OAuth service
desktop/src/main/api/oauth/service.ts
Job execution
- Job coordinator
desktop/src/main/coordinator.ts - Muse adapters
desktop/src/main/adapter - Vibes integration
desktop/src/main/adapter/vibes - Desktop services
desktop/src/main/services.ts
Local data
- Domain repository
desktop/src/main/repo.ts - SQLite database
desktop/src/main/db.ts - API key store
desktop/src/main/api/store.ts - Media handling
desktop/src/main/media.ts
Shared content
- Guide content
content/chapters.ts - Agent instructions
content/agents/agents.ts - Use cases
content/usecases/usecases.ts - Content routes
content/routes.ts
Other components
- Person
- AI agents
- Muse session
Connections 26
- Person → Desktop UI: uses
README.md - AI agents → API server: requests jobs
README.md - API server → Job API service: routes requests
desktop/src/main/api/server.ts - API server → OAuth routes: dispatches OAuth
desktop/src/main/api/server.ts - OAuth routes → OAuth service: handles protocol
desktop/src/main/api/oauth/http.ts - API controller → OAuth service: configures
desktop/src/main/api/controller.ts - Job API service → Job coordinator: submits jobs
desktop/src/main/api/service.ts - Job API service → Domain repository: reads assets
desktop/src/main/api/service.ts - Job API service → API key store: checks keys
desktop/src/main/api/service.ts - Desktop UI → IPC handlers: invokes commands
- Main process → IPC handlers: registers handlers
desktop/src/main/main.ts - Main process → API controller: creates controller
desktop/src/main/main.ts - Main process → Job coordinator: starts runtime
desktop/src/main/main.ts - IPC handlers → Job coordinator: dispatches commands
desktop/src/main/ipcHandlers.ts - IPC handlers → Desktop services: dispatches services
desktop/src/main/ipcHandlers.ts - Desktop services → Job coordinator: manages batches
desktop/src/main/services.ts - Desktop services → Domain repository: reads and writes
desktop/src/main/services.ts - Job coordinator → Domain repository: persists job state
desktop/src/main/coordinator.ts - Domain repository → SQLite database: queries
desktop/src/main/repo.ts - Job coordinator → Muse adapters: executes jobs
desktop/src/main/coordinator.ts - Muse adapters → Muse session: uses signed-in session
README.md - Job coordinator → Vibes integration: supports integration
- Domain repository → Media handling: stores asset records
- Content routes → Guide content: routes content
content/routes.ts - Content routes → Agent instructions: routes content
content/routes.ts - Content routes → Use cases: routes content
content/routes.ts