How xiaotianfotos/homerail works
HomeRail is a self-hosted agent runtime that turns voice or text requests into auditable, replayable DAG workflows. Its principal path is user request → CLI or Agent UI → Manager orchestration → per-node Worker execution → inspectable run state and evidence. The README documents the service topology and product capabilities; source excerpts confirm selected orchestration, persistence, and workspace-preparation calls. Many UI, voice, and route implementations were not sampled, so those relationships are documented at the README level rather than inferred from names.
Main entry points: routes.ts Manager API · lifecycle-handler.ts Node service · store.ts Run state store · index.ts HomeRail CLI
Components 19
User interaction
- HomeRail CLI
homerail_cli/src/index.ts - Manager transport
homerail_cli/src/client.ts - Agent UI
agent-ui/src/views/agent/index.vue - Voice surface
agent-ui/src/components/agent/AgentVoiceCockpit.vue - Generated interface
homerail_manager/src/generative-ui/surface-composer.ts
DAG orchestration
- DAG engine
homerail_manager/src/orchestration/dag-engine.ts - Workflow graph
homerail_manager/src/orchestration/graph.ts - Run supervisor
homerail_manager/src/runtime/dag-manager-supervisor.ts
Worker execution
- Node service
homerail_node/src/control-plane/lifecycle-handler.ts - Workspace preparation
homerail_node/src/storage/workspace-prepare.ts - Workspace inputs
homerail_node/src/storage/workspace-inputs.ts - DAG Worker
homerail_worker/src/index.ts - Agent turn runner
homerail_worker/src/agent/turn-controller.ts - Plugin runtime
homerail_node/src/runtime/plugin-runtime-service.ts
Runtime platform
- Manager API
homerail_manager/src/server/routes.ts - Run state store
homerail_manager/src/persistence/store.ts - Manager database
homerail_manager/src/persistence/db.ts
Other components
- Home user
- Model endpoint
Connections 21
- Home user → HomeRail CLI: operates
README.md - Home user → Agent UI: requests work
README.md - Home user → Voice surface: speaks intent
README.md - HomeRail CLI → Manager transport: issues commands
homerail_cli/src/index.ts - Manager transport → Manager API: sends API requests
homerail_cli/src/client.ts - Agent UI → Manager API: uses Manager
README.md - Voice surface → Manager API: sends voice requests
README.md - Manager API → DAG engine: starts DAG runs
README.md - DAG engine → Workflow graph: uses graph structure
homerail_manager/src/orchestration/dag-engine.ts - Manager API → Run supervisor: supervises runs
- Run supervisor → Run state store: loads run metadata
homerail_manager/src/runtime/dag-manager-supervisor.ts - Run state store → Workflow graph: reads graph
homerail_manager/src/persistence/store.ts - Run state store → Manager database: uses database
homerail_manager/src/persistence/store.ts - Manager API → Node service: coordinates services
README.md - Node service → Workspace preparation: prepares workspace
homerail_node/src/control-plane/lifecycle-handler.ts - Node service → Workspace inputs: materializes inputs
homerail_node/src/control-plane/lifecycle-handler.ts - Node service → DAG Worker: provisions containers
README.md - DAG Worker → Agent turn runner: runs agent turns
- Agent turn runner → Model endpoint: requests model output
README.md - Manager API → Generated interface: serves generated views
README.md - Node service → Plugin runtime: supports plugin execution
homerail_node/src/control-plane/lifecycle-handler.ts