How aleksbuss/orchestra works
Orchestra is a local-first AI workspace. Its primary workflow is a user chat request routed through the chat API to an agent, which can run a Mixture-of-Agents ensemble and return a response while chat state and usage are persisted. Major supporting capabilities include project and knowledge management, scheduled jobs, Telegram integration, live UI events, and cost visibility. Edges are limited to relationships shown by excerpts, the SOURCE INDEX, or README; unsampled feature wiring is not asserted.
Main entry points: agent.ts Agent runtime · route.ts Chat API · chat-store.ts Chat storage · chat-panel.tsx Chat interface
Components 24
User experience
- Chat interface
src/components/chat/chat-panel.tsx - Chat API
src/app/api/chat/route.ts - UI event stream
src/app/api/events/route.ts
Agent orchestration
- Agent runtime
src/lib/agent/agent.ts - MoA ensemble
src/lib/agent/moa.ts - Model providers
src/lib/providers/llm-provider.ts - Agent tools
src/lib/agent/agent-tools.ts
Workspace services
- Memory service
src/lib/memory/memory.ts - Knowledge service
src/lib/memory/knowledge.ts - Project storage
src/lib/storage/project-store.ts - Chat storage
src/lib/storage/chat-store.ts - Settings API
src/app/api/settings/route.ts - Settings storage
src/lib/storage/settings-store.ts - Scheduled jobs
src/lib/cron/service.ts - Telegram integration
src/app/api/integrations/telegram/route.ts - Telegram configuration
src/lib/storage/telegram-integration-store.ts
Runtime platform
- Event bus
src/lib/realtime/event-bus.ts - Usage and cost
src/lib/cost/accumulator.ts - Observability
src/lib/observability/logger.ts - Data directory
src/lib/storage/data-dir.ts - Safe file access
src/lib/storage/fs-utils.ts
Other components
- Workspace user
- Model services
- Telegram service
Connections 29
- Workspace user → Chat interface: asks
README.md - Chat interface → Chat API: submits chat
- Chat API → Agent runtime: runs turn
src/app/api/chat/route.ts - Chat API → Chat storage: creates and reads
src/app/api/chat/route.ts - Chat API → Scheduled jobs: starts scheduler
src/app/api/chat/route.ts - Chat API → Observability: adds log context
src/app/api/chat/route.ts - Agent runtime → MoA ensemble: runs ensemble
src/lib/agent/agent.ts - Agent runtime → Chat storage: loads and updates
src/lib/agent/agent.ts - Agent runtime → Usage and cost: folds usage
src/lib/agent/agent.ts - Agent runtime → Model providers: calls models
src/lib/agent/agent.ts - Agent runtime → Agent tools: assembles tools
src/lib/agent/agent.ts - Agent runtime → Memory service: recalls context
src/lib/agent/agent.ts - MoA ensemble → Model services: consults experts
README.md - Model providers → Model services: requests inference
- Chat storage → Event bus: publishes changes
src/lib/storage/chat-store.ts - UI event stream → Event bus: subscribes events
src/app/api/events/route.ts - Chat interface → UI event stream: receives updates
- Knowledge service → Memory service: uses memory
src/lib/memory/knowledge.ts - Settings API → Settings storage: reads and saves
src/app/api/settings/route.ts - Telegram integration → Telegram configuration: loads configuration
src/app/api/integrations/telegram/route.ts - Telegram integration → Telegram service: handles messages
- Scheduled jobs → Agent runtime: runs scheduled turns
src/lib/cron/service.ts - Scheduled jobs → Project storage: loads project data
src/lib/cron/service.ts - Chat storage → Safe file access: locks and writes
src/lib/storage/chat-store.ts - Project storage → Safe file access: validates and writes
src/lib/storage/project-store.ts - Settings storage → Safe file access: locks settings file
src/lib/storage/settings-store.ts - Chat storage → Data directory: locates data
src/lib/storage/chat-store.ts - Project storage → Data directory: locates data
src/lib/storage/project-store.ts - Settings storage → Data directory: locates settings
src/lib/storage/settings-store.ts