How bhanuj-ai/ai-governance-oss works
BHANUJ is an AI governance control plane: it observes externally owned AI activity, evaluates evidence and policy, records explainable decisions and lineage, and supports evaluation, causal audits, interventions, and controlled replay. The REST API is the central runtime entry point; the Studio and MCP clients initiate review and governance operations. The README documents major capabilities that are not individually sampled, so those subsystems are represented at their exact enclosing directories; arrows are limited to relationships visible in the README or sampled source index/excerpts.
Main entry points: app.py REST control plane · decisions Decision engine · causal_audit Causal audit · agent_execution Agent executions
Components 25
Access & Control
- REST control plane
src/ai_governance/api/app.py - Identity & tenancy
src/ai_governance/tenancy - Async jobs
src/ai_governance/domain/jobs - Events & integrations
src/ai_governance/events - Persistence adapters
src/ai_governance/repositories
Governance Decisions
- Decision engine
src/ai_governance/decisions - Policy engine
src/ai_governance/decisions/policies.py - Audit & lineage
src/ai_governance/api/routers/audit.py
Knowledge & Evidence
- Asset registries
src/ai_governance/api/dependencies - Governance ontology
src/ai_governance/ontology
Runtime & Evaluation
- Agent executions
src/ai_governance/domain/agent_execution - Evaluation
src/ai_governance/evaluation - Experiments
src/ai_governance/services/experiment_api_service.py - Runtime findings
src/ai_governance/domain/runtime_findings - Causal audit
src/ai_governance/domain/causal_audit - Evidence interventions
src/ai_governance/domain/causal_audit/intervention_policy.py - Controlled replay
src/ai_governance/domain/replay
Product Interfaces
- AIGP Studio
console/components - MCP server
src/ai_governance/mcp/server.py - Ontology explorer
console/components/graph/GraphExplorer.tsx - Causal audit views
console/components/agent-runtime/CausalAuditPage.tsx - Policy management
console/components/policies/PolicyEnginePages.tsx - MCP tool client
src/ai_governance/mcp/clients/rest_client.py
Other components
- Governance user
- AI runtime owner
Connections 30
- Governance user → AIGP Studio: reviews
README.md - AIGP Studio → REST control plane: requests
- REST control plane → Identity & tenancy: enforces access
src/ai_governance/api/app.py - AI runtime owner → Agent executions: provides evidence
README.md - REST control plane → Asset registries: wires services
src/ai_governance/api/dependencies/__init__.py - REST control plane → Governance ontology: routes queries
src/ai_governance/api/app.py - Governance ontology → Persistence adapters: queries graph
- REST control plane → Decision engine: governs outcomes
- Decision engine → Policy engine: evaluates rules
README.md - Decision engine → Audit & lineage: preserves lineage
README.md - REST control plane → Agent executions: routes executions
src/ai_governance/api/app.py - REST control plane → Evaluation: routes evaluation
- REST control plane → Experiments: wires experiments
- Experiments → Evaluation: uses evaluation
src/ai_governance/services/experiment_api_service.py - Agent executions → Runtime findings: emits findings
- REST control plane → Causal audit: routes audits
- Causal audit → Evidence interventions: applies policy
README.md - Causal audit → Controlled replay: runs controlled replay
README.md - Controlled replay → AI runtime owner: executes in runtime
README.md - REST control plane → Async jobs: submits work
- REST control plane → Events & integrations: installs telemetry
src/ai_governance/api/app.py - REST control plane → Persistence adapters: wires repositories
- MCP server → MCP tool client: uses REST client
src/ai_governance/mcp/server.py - MCP tool client → REST control plane: calls API
- Governance user → Ontology explorer: explores lineage
README.md - Governance user → Causal audit views: reviews findings
README.md - Governance user → Policy management: manages policies
README.md - Ontology explorer → REST control plane: queries graph
- Causal audit views → REST control plane: requests audits
- Policy management → REST control plane: requests policy