How kucau0901/jarvis-voice-agent works
Jarvis is a browser-based, hands-free assistant backed by a Cloudflare Worker. A person unlocks or pairs a screen, then speaks live, uses push-to-talk, or types; the Worker routes requests through a model and tools, returning speech, text, or display content. Distinct product branches include memory, alerts, background jobs, routines, family/device access, camera vision, and integrations. The graph uses README statements for documented capabilities and sampled imports for visible wiring; many individual route-to-service calls were not sampled, so those links are intentionally not asserted.
Main entry points: main.ts Jarvis screen · index.ts HTTP entry · lib/router.ts Tool router · routes/router.ts Router endpoint
Components 22
Browser experience
- Jarvis screen
src/app/main.ts - Live voice
src/app/loud.ts - Push to talk
src/app/ptt.ts - Typed chat
src/app/chat.ts - Family controls
src/app/ui/Family.ts - Alert delivery UI
src/app/alerts.ts
Worker runtime
- HTTP entry
src/worker/index.ts - Identity and access
src/worker/lib/access.ts - Router endpoint
src/worker/routes/router.ts
Assistant capabilities
- Tool router
src/worker/lib/router.ts - Model selection
src/worker/lib/router-model.ts - Tool registry
src/worker/tools/registry.ts - Connected services
src/worker/tools - Camera vision
src/worker/lib/cameras.ts
State and automation
- Memory
src/worker/lib/memory.ts - Persistent state
src/worker/state.ts - Background jobs
src/worker/lib/jobs.ts - Routines and watches
src/worker/lib/routines.ts - Alerts and relays
src/worker/lib/alerts.ts
Other components
- Person
- Push notifications
- MCP agents
Connections 22
- Person → Jarvis screen: uses
README.md - Jarvis screen → Live voice: starts voice
src/app/main.ts - Jarvis screen → Push to talk: offers mode
README.md - Jarvis screen → Typed chat: offers mode
README.md - Jarvis screen → Family controls: opens controls
src/app/main.ts - Jarvis screen → Alert delivery UI: fetches alerts
src/app/main.ts - Jarvis screen → HTTP entry: sends requests
README.md - HTTP entry → Identity and access: checks access
src/worker/index.ts - HTTP entry → Router endpoint: routes requests
src/worker/index.ts - Router endpoint → Model selection: selects model
src/worker/routes/router.ts - Tool router → Model selection: resolves model
src/worker/lib/router.ts - Tool router → Tool registry: loads tools
src/worker/lib/router.ts - Tool registry → Connected services: registers integrations
src/worker/tools/registry.ts - Person → Camera vision: asks about scene
README.md - Person → Memory: shares facts
README.md - Memory → Persistent state: persists in
src/worker/state.ts - Person → Background jobs: requests research
README.md - Background jobs → Alerts and relays: delivers result
README.md - Person → Routines and watches: sets routine
README.md - Routines and watches → Persistent state: runs from
src/worker/state.ts - Alerts and relays → Push notifications: sends notifications
README.md - Person → MCP agents: connects agent
README.md