How himanshuupadhyay029-sys/onpremsih117 works
KAVACH is an on-premise engineering workbench. An operator submits a task in the React console; the FastAPI service hands work to a LangGraph agent, which plans and routes steps to local models, the knowledge vault, or task tools, then returns results for review. Separate console capabilities cover vault management, approvals, audit, and administration. PostgreSQL stores application records, while audit logs and host monitoring/firewall controls provide operational safeguards. The graph reflects documented capabilities and indexed imports; unsampled endpoint and internal details are represented only where relationships are documented.
Main entry points: main.py FastAPI service · agent.py LangGraph agent · tools_dispatch.py Tool dispatch · App.jsx React console
Components 29
Operator console
- React console
kavach/frontend-react/src/App.jsx - Task workspace
kavach/frontend-react/src/components/NewTaskScreen.jsx - Vault screen
kavach/frontend-react/src/components/KnowledgeVaultScreen.jsx - Approval screen
kavach/frontend-react/src/components/ApprovalsScreen.jsx - Audit screen
kavach/frontend-react/src/components/AuditLogScreen.jsx - Admin screens
kavach/frontend-react/src/components/UserManagementScreen.jsx
API and agent
- FastAPI service
kavach/backend/main.py - Authentication
kavach/backend/auth/routes.py - LangGraph agent
kavach/backend/brain/agent.py - Task routing
kavach/backend/brain/router.py - Tool dispatch
kavach/backend/brain/tools_dispatch.py - Model registry
kavach/backend/engine/registry.py
Knowledge and tools
- Vault ingestion
kavach/backend/vault/ingest.py - Hybrid retrieval
kavach/backend/vault/retrieve.py - Grounded search
kavach/backend/tools/search.py - OCR
kavach/backend/tools/ocr.py - Image analysis
kavach/backend/tools/vision.py - Calculation
kavach/backend/tools/calc.py - Code execution
kavach/backend/tools/code.py - Docker sandbox
kavach/backend/tools/sandbox.py - Office generation
kavach/backend/tools/writer.py
Records and controls
- Approval gate
kavach/backend/guard/approve.py - Hash-chain audit
kavach/backend/audit/logbook.py - PostgreSQL records
kavach/backend/db/models.py - Host protections
kavach/backend/shield/monitor.py
Local services
- Ollama models
- PostgreSQL
- Docker runtime
Other components
- Operator
Connections 33
- Operator → React console: submits tasks
README.md - React console → Task workspace: renders
kavach/frontend-react/src/App.jsx - Task workspace → FastAPI service: sends requests
README.md - React console → FastAPI service: checks session
kavach/frontend-react/src/App.jsx - FastAPI service → LangGraph agent: invokes
kavach/backend/main.py - LangGraph agent → Task routing: routes tasks
kavach/backend/brain/agent.py - LangGraph agent → Tool dispatch: dispatches steps
kavach/backend/brain/agent.py - LangGraph agent → Model registry: selects models
kavach/backend/brain/agent.py - Model registry → Ollama models: lists models
kavach/backend/engine/registry.py - LangGraph agent → Ollama models: runs inference
README.md - Vault screen → FastAPI service: manages documents
README.md - FastAPI service → Vault ingestion: ingests uploads
README.md - Vault ingestion → OCR: extracts scans
kavach/backend/vault/ingest.py - Grounded search → Hybrid retrieval: retrieves passages
kavach/backend/tools/search.py - Tool dispatch → Grounded search: dispatches search
kavach/backend/brain/tools_dispatch.py - Tool dispatch → OCR: dispatches OCR
kavach/backend/brain/tools_dispatch.py - Tool dispatch → Image analysis: dispatches vision
kavach/backend/brain/tools_dispatch.py - Tool dispatch → Calculation: dispatches calculation
kavach/backend/brain/tools_dispatch.py - Tool dispatch → Code execution: dispatches code
kavach/backend/brain/tools_dispatch.py - Code execution → Docker sandbox: executes in
README.md - Docker sandbox → Docker runtime: starts containers
README.md - Tool dispatch → Office generation: dispatches authoring
kavach/backend/brain/tools_dispatch.py - LangGraph agent → Approval gate: requests review
kavach/backend/brain/agent.py - Approval screen → Approval gate: reviews drafts
README.md - LangGraph agent → PostgreSQL records: persists run state
README.md - FastAPI service → Authentication: mounts routes
kavach/backend/main.py - Authentication → PostgreSQL records: reads users
kavach/backend/auth/routes.py - PostgreSQL records → PostgreSQL: stores records
- LangGraph agent → Hash-chain audit: records events
kavach/backend/brain/agent.py - Approval gate → Hash-chain audit: records decisions
kavach/backend/guard/approve.py - Audit screen → FastAPI service: views audit
README.md - Admin screens → FastAPI service: administers users
README.md - FastAPI service → Host protections: exposes controls
kavach/backend/main.py