How saifulhaqueniloy/supremeai works
SupremeAI is a governed, model-agnostic task-execution platform. Its documented user journey is to understand a goal, discover and compose capabilities, apply policy, execute, verify or repair, deliver, and retain reusable experience. The graph combines that workflow with sampled task, context, LLM, governance, and learning components, plus README-documented capability areas. Some source-index modules are not present in the supplied tree; their paths come from the index. Unsampled subsystem links are omitted or marked unverified.
Main entry points: task_engine.py Task State Machine · llm_gateway LLM Gateway · engine.py Context Assembly · autonoguard_engine.py AutonoGuard
Components 28
Task Experience
- Frontend
frontend
Planning & Execution
- Task State Machine
backend/adaptive_engine/task_engine.py - Capability Surface
backend/adaptive_engine - Pipeline Recipes
tools/pipeline_recipe_compiler.py - Agent Debate
backend/engine/debate_engine.py - Video-to-Code
backend/services/video_to_code_pipeline.py
Models & Context
- Context Assembly
backend/context/engine.py - Context Items
backend/context/items.py - Context Budget
backend/context/budget.py - Model Router
backend/brain/model_router.py - LLM Gateway
backend/core/llm/llm_gateway - Completions
backend/core/llm/llm_gateway/completion.py - Token Budget
backend/core/llm/token_budget.py - RAG Pipeline
backend/memory/rag_pipeline.py
Governance & Learning
- External Policy
backend/external_agents/control/policy_engine.py - AutonoGuard
backend/core/autonoguard_engine.py - Learning Pipeline
backend/evolution/learning_pipeline.py - Hypothesis Learning
backend/learning/hypothesis_engine.py
API & State
- FastAPI
backend/main.py - Mission API
backend/api/routes/missions.py - Memory Service
backend/services/memory_service.py - Adaptive Store
backend/adaptive_engine/_store.py - Redis Cache
backend/core/cache/redis_manager.py - Event Bus
backend/core/messaging/event_bus.py - Configuration
backend/core/config.py - Free-Tier Tracking
backend/core/llm/free_tier_tracker.py
Other components
- User
- External Capabilities
Connections 27
- User → Frontend: submits goal
README.md - Frontend → FastAPI: requests tasks
README.md - FastAPI → Mission API: routes requests
README.md - Mission API → Task State Machine: starts task
README.md - Task State Machine → Capability Surface: checks capabilities
README.md - Task State Machine → Pipeline Recipes: composes plan
README.md - Task State Machine → External Policy: applies policy
README.md - Task State Machine → Context Assembly: assembles context
README.md - Context Assembly → Context Budget: packs items
backend/context/engine.py - Context Assembly → Context Items: filters items
backend/context/engine.py - Task State Machine → Model Router: executes plan
README.md - Model Router → LLM Gateway: routes models
backend/brain/model_router.py - LLM Gateway → Completions: calls completion
backend/core/llm/llm_gateway/__init__.py - LLM Gateway → Token Budget: uses budget
- Task State Machine → Agent Debate: verifies proposals
README.md - Task State Machine → AutonoGuard: governs execution
README.md - Task State Machine → External Capabilities: delegates capability
README.md - Task State Machine → Adaptive Store: persists tasks
backend/adaptive_engine/task_engine.py - Pipeline Recipes → Memory Service: injects recipes
tools/pipeline_recipe_compiler.py - RAG Pipeline → LLM Gateway: queries models
backend/memory/rag_pipeline.py - Learning Pipeline → Hypothesis Learning: detects patterns
- AutonoGuard → Redis Cache: stores state
backend/core/autonoguard_engine.py - AutonoGuard → Event Bus: publishes events
backend/core/autonoguard_engine.py - LLM Gateway → Configuration: loads settings
backend/core/llm/llm_gateway/__init__.py - FastAPI → Configuration: configures service
- Video-to-Code → Model Router: analyzes frames
backend/services/video_to_code_pipeline.py - LLM Gateway → Free-Tier Tracking: reports status
backend/api/routes/llm_gateway_routes.py