How kaimnancy/gauri-livestock-assistant works
Gauri is a livestock record-keeping and triage assistant. A caregiver submits an English description and optional photo; the orchestrator applies deterministic safety checks, routes the task, and manages animal context and clarification. Record tasks use agent tools and file-backed JSON/Markdown profiles; other documented routes include triage, visual health checks, and general queries. Phase 2 agents and regional-language replies are represented by stubs. Relationships are based on README claims and shown source references; where the live record-agent wiring is unclear, the edge is marked unverified.
Main entry points: agent.py Task Orchestrator · record_agent.py Record Agent · record_tools.py Record Tools · schemas.py Payload and Response Schemas
Components 16
Input and Coordination
- Task Orchestrator
Gauri/gauri_app/orchestrator/agent.py - Intent Router
Gauri/gauri_app/orchestrator/agent.py - Session and Roster State
Gauri/gauri_app/core/state_keys.py
Safety
- Safety Gate
Gauri/gauri_app/core/safety.py
Agent Capabilities
- Record Agent
Gauri/gauri_app/record/record_agent.py - Triage Handler
Gauri/gauri_app/orchestrator/stubs.py - Visual Health Check
Gauri/gauri_app/orchestrator/stubs.py - General Query Handler
Gauri/gauri_app/orchestrator/stubs.py - Reply Formatter
Gauri/gauri_app/orchestrator/stubs.py
Animal Records
- Record Tools
Gauri/gauri_app/tools/record_tools.py - Animal Document Store
Gauri/gauri_app/core/doc_store.py
Shared Contracts
- Payload and Response Schemas
Gauri/gauri_app/core/schemas.py - Model Factory
Gauri/gauri_app/core/models.py
Other components
- Caregiver
- Vet / 1962
- Ollama Model Service
Connections 18
- Caregiver → Task Orchestrator: submits request
README.md - Task Orchestrator → Safety Gate: checks input
Gauri/gauri_app/orchestrator/agent.py - Task Orchestrator → Intent Router: classifies request
Gauri/gauri_app/orchestrator/agent.py - Task Orchestrator → Session and Roster State: updates state
Gauri/gauri_app/orchestrator/agent.py - Safety Gate → Vet / 1962: escalates emergencies
README.md - Task Orchestrator → Triage Handler: dispatches triage
README.md - Task Orchestrator → Visual Health Check: dispatches visual check
README.md - Task Orchestrator → General Query Handler: dispatches query
README.md - Task Orchestrator → Record Agent: may dispatch record task
- Task Orchestrator → Record Tools: uses roster tools
Gauri/gauri_app/orchestrator/agent.py - Record Agent → Record Tools: invokes tools
Gauri/gauri_app/record/record_agent.py - Record Tools → Animal Document Store: reads and writes
Gauri/gauri_app/tools/record_tools.py - Task Orchestrator → Reply Formatter: formats response
Gauri/gauri_app/orchestrator/agent.py - Triage Handler → Payload and Response Schemas: returns agent response
Gauri/gauri_app/orchestrator/stubs.py - Visual Health Check → Payload and Response Schemas: returns agent response
Gauri/gauri_app/orchestrator/stubs.py - Record Agent → Payload and Response Schemas: uses task contracts
Gauri/gauri_app/record/record_agent.py - Record Agent → Model Factory: gets model
Gauri/gauri_app/record/record_agent.py - Model Factory → Ollama Model Service: configures local model
Gauri/gauri_app/core/models.py