How nano-muse/nanomuse works
nanoMuse is a cross-device personal agent, with phone, desktop, web console, and a relay. The main workflow is that a person sends a request through a client; the always-on runtime manages conversations and delegates work to the agent, tools, or coding service, then streams activity and results back. The repository also includes memory, device coordination, chat-app channels, and account/cloud services. Some client and backend connections are documented only at a high level; those links are marked unverified rather than inferred from names.
Main entry points: server/service.py Always-on service · app.py Runtime composition · hub/service.py Device hub · ChatStore.swift iOS chat
Components 16
User clients
- Web console
web/src/App.tsx - Desktop app
harness/desktop/src/main.ts - iOS chat
android/src/ios/Agent/Chat/ChatStore.swift
Agent runtime
- Always-on service
nanomuse/server/service.py - Runtime composition
nanomuse/app.py - Agent core
nanomuse/agent/core.py - Event bus
nanomuse/server/events.py - Memory embeddings
nanomuse/memory/embeddings.py
Agent capabilities
- Coding service
nanomuse/coding/service.py - Chat channels
nanomuse/channels/manager.py
Device coordination
- Device hub
nanomuse/hub/service.py - Sync engine
nanomuse/sync/engine.py - iCloud sync
android/src/ios/Agent/Sync/CloudSyncEngine.swift
Cloud services
- Cloud relay
cloud/nanomuse_cloud/service.py - Relay database
cloud/nanomuse_cloud/db.py
Other components
- Person
Connections 19
- Person → Web console: uses
README.md - Person → Desktop app: uses
README.md - Person → iOS chat: uses
README.md - Web console → Always-on service: sends requests
- Desktop app → Always-on service: connects to
- iOS chat → Always-on service: shares conversations
README.md - Always-on service → Runtime composition: owns runtime
nanomuse/server/service.py - Runtime composition → Agent core: composes agent
- Always-on service → Event bus: publishes events
nanomuse/server/service.py - Always-on service → Coding service: uses service
nanomuse/server/service.py - Always-on service → Device hub: uses service
nanomuse/server/service.py - Always-on service → Chat channels: routes chat
nanomuse/channels/manager.py - Chat channels → Always-on service: runs requests
nanomuse/channels/manager.py - Runtime composition → Memory embeddings: configures memory
nanomuse/app.py - Device hub → Sync engine: coordinates sync
nanomuse/hub/service.py - Sync engine → Always-on service: publishes updates
nanomuse/sync/engine.py - iCloud sync → iOS chat: reads and updates
android/src/ios/Agent/Sync/CloudSyncEngine.swift - Device hub → Cloud relay: uses account relay
- Cloud relay → Relay database: uses database
cloud/nanomuse_cloud/service.py