How manvitha-kopela/sugar-ai works
Sugar-AI is a FastAPI coding assistant. Users submit questions or code to API endpoints; the API delegates RAG, direct-prompt, chat, or debugging work to an initialized agent and returns generated answers. The app also supports API-key and OAuth access, key requests and administration, plus an optional repository-update webhook. The graph preserves the documented endpoint modes and provider choices; some routes and provider implementations were not sampled, so only documented or indexed relationships are shown.
Main entry points: main.py Startup initialization · ai.py RAG and generation · base.py Provider interface · __init__.py Provider factory
Components 24
Web and access
- Assistant API
app/routes/api.py - Admin routes
app/routes/admin.py - Login and keys
app/routes/auth.py - Web pages
app/routes/web.py - HTML templates
templates - API-key and OAuth access
app/auth.py - Repository webhook
app/routes/webhook.py
Assistant workflow
- RAG and generation
app/ai.py - Document retrieval
app/ai.py - Prompt templates
app/prompts.py - Sugar documentation
docs
Model providers
- Provider factory
app/providers/__init__.py - Provider interface
app/providers/base.py - Hugging Face
app/providers/huggingface.py - Ollama
app/providers/ollama.py - Gemini
app/providers/gemini.py
Application platform
- API-key database
app/database.py - Runtime settings
app/config.py - FastAPI application
app/__init__.py - Startup initialization
main.py
Other components
- API user
- Browser user
- GitHub webhook
- OpenAI-compatible API
Connections 29
- API user → Assistant API: submits requests
README.md - Assistant API → RAG and generation: runs workflows
app/routes/api.py - RAG and generation → Document retrieval: retrieves documents
app/ai.py - Document retrieval → Sugar documentation: indexes documentation
README.md - RAG and generation → Prompt templates: uses templates
app/ai.py - RAG and generation → Provider interface: generates with
app/ai.py - Startup initialization → FastAPI application: creates app
main.py - Startup initialization → Provider factory: selects provider
main.py - Startup initialization → RAG and generation: initializes agent
main.py - Startup initialization → API-key database: loads keys
main.py - Startup initialization → Runtime settings: reads settings
main.py - Startup initialization → Assistant API: injects agent
main.py - Provider factory → Hugging Face: creates provider
app/providers/__init__.py - Provider factory → Ollama: creates provider
app/providers/__init__.py - Provider factory → Gemini: creates provider
app/providers/__init__.py - Hugging Face → Provider interface: implements interface
app/providers/huggingface.py - Ollama → Provider interface: implements interface
app/providers/ollama.py - Gemini → Provider interface: implements interface
app/providers/gemini.py - Provider interface → OpenAI-compatible API: calls completions
app/providers/base.py - Browser user → Web pages: opens pages
README.md - Web pages → HTML templates: renders pages
app/routes/web.py - Browser user → Login and keys: uses login forms
README.md - Login and keys → API-key and OAuth access: uses OAuth helpers
app/routes/auth.py - API-key and OAuth access → API-key database: queries keys
app/auth.py - Admin routes → API-key database: manages keys
app/routes/admin.py - Assistant API → API-key and OAuth access: verifies keys
app/routes/api.py - FastAPI application → API-key and OAuth access: sets up OAuth
app/__init__.py - FastAPI application → API-key database: creates tables
app/__init__.py - GitHub webhook → Repository webhook: posts updates
app/routes/webhook.py