How shashwathsd2006-glitch/sovereign-ai works
Sovereign AI is an on-premise workbench for industrial maintenance teams. The principal workflow is an engineer’s request through the Next.js client and FastAPI model router, then to direct local text generation, document-grounded RAG, or image analysis; the agent workflow combines vision findings with document retrieval for maintenance assessment. Document upload feeds extraction, chunking, and embeddings into local vector storage. The README also documents model-routing, security, and activity views. The supplied tree contains no application source, so service-level paths and internal wiring are based on README descriptions, not inspected implementations.
Components 23
Workbench client
- Workbench routes
- Typed API client
- AI assistant
- Knowledge base
- Document management
- Image analysis
- Maintenance agents
- Model router view
- Security center
- Activity logs
AI services
- FastAPI entry
- Model router
- Vision analysis
- Maintenance assessment
- Security status
- Activity events
Knowledge processing
- RAG pipeline
- Document processing
- Local embeddings
Local infrastructure
- ChromaDB
- Document files
- Ollama
Other components
- Engineer
Connections 38
- Engineer → Workbench routes: uses
- Workbench routes → AI assistant: opens
- Workbench routes → Knowledge base: opens
- Workbench routes → Document management: opens
- Workbench routes → Image analysis: opens
- Workbench routes → Maintenance agents: opens
- Workbench routes → Model router view: opens
- Workbench routes → Security center: opens
- Workbench routes → Activity logs: opens
- AI assistant → Typed API client: sends requests
- Knowledge base → Typed API client: sends requests
- Document management → Typed API client: sends requests
- Image analysis → Typed API client: sends requests
- Maintenance agents → Typed API client: sends requests
- Model router view → Typed API client: sends requests
- Security center → Typed API client: sends requests
- Activity logs → Typed API client: sends requests
- Typed API client → FastAPI entry: HTTP JSON
- FastAPI entry → Model router: dispatches
- Model router → RAG pipeline: routes text
- Model router → Vision analysis: routes images
- Model router → Ollama: routes plain text
- RAG pipeline → Local embeddings: embeds query
- RAG pipeline → ChromaDB: retrieves chunks
- RAG pipeline → Ollama: generates answer
- Document management → FastAPI entry: uploads PDFs
- FastAPI entry → Document processing: dispatches upload
- Document processing → Local embeddings: embeds chunks
- Document processing → ChromaDB: indexes chunks
- Document processing → Document files: stores files
- Vision analysis → Ollama: requests analysis
- Maintenance assessment → Vision analysis: requests findings
- Maintenance assessment → RAG pipeline: retrieves evidence
- Maintenance assessment → Ollama: reasons over results
- FastAPI entry → Security status: serves status
- FastAPI entry → Activity events: serves events
- Security status → ChromaDB: checks state
- Security status → Ollama: checks status