How sachinkaushik/qsr-agent works
QSR Agentic Service is an edge-based restaurant assistant: operators ask questions through the web UI or Hermes CLI, Hermes uses a local OVMS/Qwen model, and MCP services own domain data and actions. A parallel event workflow receives subscribed events, gathers validated service context, proposes actions for operator approval, and reports subscribed alerts. Autonomy source is well represented; service internals and some UI wiring are unsampled, so those links are included only where documented or directly evidenced.
Main entry points: worker.py Autonomy assembly · controller.py Event and approval controller · app.py Operator web UI · event_agent.py Event reasoning
Components 18
Operator interface
- Operator web UI
operator-ui/app.py - Chat and alerts
operator-ui/static/index.html
Hermes and model
- Hermes agent
- OVMS Qwen model
- Domain skills
qsr-skills
Event autonomy
- Autonomy assembly
autonomy/worker.py - Capability registry
autonomy/registry.py - Event reasoning
autonomy/event_agent.py - Service capabilities
autonomy/service_capabilities.py - Event and approval controller
autonomy/controller.py - Proposal and event state
autonomy/store.py - Stdio MCP client
autonomy/mcp.py - Hermes runner
autonomy/advisor.py
Restaurant services
- Kiosk MCP service
tests/mcp-services/kiosk_server.py - Order accuracy MCP service
tests/mcp-services/order_accuracy_server.py - Restaurant domain systems
Other components
- Operator
- Subscribed event source
Connections 32
- Operator → Operator web UI: asks questions
README.md - Chat and alerts → Operator web UI: sends chat requests
- Operator web UI → Hermes agent: runs Hermes
operator-ui/app.py - Operator → Hermes agent: uses CLI
README.md - Hermes agent → OVMS Qwen model: queries locally
README.md - Hermes agent → Domain skills: uses routing guidance
README.md - Hermes agent → Kiosk MCP service: calls MCP tools
README.md - Hermes agent → Order accuracy MCP service: calls MCP tools
README.md - Autonomy assembly → Capability registry: builds registry
autonomy/worker.py - Autonomy assembly → Service capabilities: registers defaults
autonomy/worker.py - Autonomy assembly → Stdio MCP client: creates clients
autonomy/worker.py - Autonomy assembly → Hermes runner: creates runner
autonomy/worker.py - Autonomy assembly → Event reasoning: registers agent
autonomy/worker.py - Autonomy assembly → Proposal and event state: creates proposal store
autonomy/worker.py - Autonomy assembly → Event and approval controller: builds controller
autonomy/worker.py - Service capabilities → Domain skills: registers skill files
autonomy/service_capabilities.py - Capability registry → Event reasoning: accepts event policy
autonomy/registry.py - Capability registry → Event and approval controller: constructs controller
autonomy/registry.py - Event and approval controller → Proposal and event state: records decisions
autonomy/controller.py - Event and approval controller → Event reasoning: evaluates events
- Event reasoning → Hermes runner: requests reasoning
- Event reasoning → Service capabilities: reads and validates tools
autonomy/event_agent.py - Service capabilities → Stdio MCP client: calls service tools
- Stdio MCP client → Kiosk MCP service: sends MCP requests
- Stdio MCP client → Order accuracy MCP service: sends MCP requests
- Event and approval controller → Stdio MCP client: executes approved action
- Subscribed event source → Operator web UI: posts event callback
README.md - Operator web UI → Event and approval controller: submits event
- Event and approval controller → Operator web UI: serves decisions
- Operator web UI → Chat and alerts: streams alerts
- Kiosk MCP service → Restaurant domain systems: owns domain data
README.md - Order accuracy MCP service → Restaurant domain systems: owns domain data
README.md