How hemanth2607-cyber/superflow works
SuperFlow is a multi-model agent runtime: a user submits a goal, the workflow/router can organize it into steps, and the agent loop asks a model for tool calls, gates execution through permissions, and returns results. Its major capability branches include computer use, deployment and rollback, SEO, live preview, MCP access, and model training. The graph follows explicit README and source-index relationships; secret-vault implementation files are absent from the supplied tree, so that subsystem is not mapped.
Main entry points: registry.py Tool Registry · engine.py Agent Loop · deploy_tools.py Deployment Tools · seo_tools.py SEO Tools
Components 29
Agent Runtime
- Workflow Engine
agent_engine/workflow.py - Task Router
agent_engine/orchestrator/router.py - Agent Loop
agent_engine/engine.py - Tool Registry
agent_engine/tools/registry.py - Risk Gate
agent_engine/permissions.py - Audit Log
agent_engine/audit.py
Model Routing
- Ollama Client
agent_engine/model_client.py - Provider Registry
agent_engine/models/registry.py - Model Discovery
agent_engine/models/auto_discovery.py
Tool Capabilities
- Computer Tools
agent_engine/tools/computer_tools.py - Screen and Input
agent_engine/computer_use/actions.py - Session Recorder
agent_engine/computer_use/session_recorder.py - Deployment Tools
agent_engine/tools/deploy_tools.py - Deploy and History
agent_engine/deployment/spec.py - Vercel Adapter
agent_engine/deployment/adapters/vercel.py - Docker Adapter
agent_engine/deployment/adapters/docker_deploy.py - SEO Tools
agent_engine/tools/seo_tools.py - SEO Auditor
agent_engine/seo/auditor.py - Metadata Injector
agent_engine/seo/meta_injector.py - Sitemap Generator
agent_engine/seo/sitemap_generator.py - Preview Tools
agent_engine/tools/preview_tools.py - Live Preview Server
agent_engine/preview/live_server.py
External Interfaces
- MCP Bridge
agent_engine/orchestrator/mcp_bridge.py
Model Training
- Dataset Curator
agent_engine/training/dataset_curator.py - Colab Training Pipeline
agent_engine/training/colab_train_pipeline.py
Other components
- User
- Model Services
- Claude and Cursor
- Google Colab
Connections 33
- User → Workflow Engine: submits goal
- Workflow Engine → Agent Loop: runs steps
agent_engine/workflow.py - Task Router → Workflow Engine: builds workflow
agent_engine/orchestrator/router.py - Agent Loop → Ollama Client: requests response
agent_engine/engine.py - Agent Loop → Tool Registry: dispatches calls
agent_engine/engine.py - Agent Loop → Risk Gate: passes authorization
agent_engine/engine.py - Agent Loop → Audit Log: records events
agent_engine/engine.py - Ollama Client → Model Services: queries Ollama
agent_engine/model_client.py - Workflow Engine → Provider Registry: selects providers
agent_engine/workflow.py - Model Discovery → Provider Registry: registers providers
agent_engine/models/auto_discovery.py - Provider Registry → Model Services: supports hosted models
- Tool Registry → Risk Gate: checks risk
agent_engine/tools/registry.py - Computer Tools → Tool Registry: registers tools
agent_engine/tools/computer_tools.py - Computer Tools → Screen and Input: captures and acts
agent_engine/tools/computer_tools.py - Computer Tools → Session Recorder: records actions
agent_engine/tools/computer_tools.py - Session Recorder → Screen and Input: executes actions
agent_engine/computer_use/session_recorder.py - Deployment Tools → Tool Registry: registers tools
agent_engine/tools/deploy_tools.py - Deployment Tools → Deploy and History: records deployments
agent_engine/tools/deploy_tools.py - Deployment Tools → Vercel Adapter: dispatches deploy
agent_engine/tools/deploy_tools.py - Deployment Tools → Docker Adapter: dispatches deploy
agent_engine/tools/deploy_tools.py - Vercel Adapter → Deploy and History: uses spec
agent_engine/deployment/adapters/vercel.py - Docker Adapter → Deploy and History: uses spec
agent_engine/deployment/adapters/docker_deploy.py - SEO Tools → Tool Registry: registers tools
agent_engine/tools/seo_tools.py - SEO Tools → SEO Auditor: runs audits
agent_engine/tools/seo_tools.py - SEO Tools → Metadata Injector: injects metadata
agent_engine/tools/seo_tools.py - SEO Tools → Sitemap Generator: generates sitemap
agent_engine/tools/seo_tools.py - Preview Tools → Tool Registry: registers tools
agent_engine/tools/preview_tools.py - Preview Tools → Live Preview Server: starts server
agent_engine/tools/preview_tools.py - MCP Bridge → Tool Registry: exposes tools
agent_engine/orchestrator/mcp_bridge.py - Claude and Cursor → MCP Bridge: uses bridge
- Google Colab → Colab Training Pipeline: runs training
- User → Dataset Curator: curates data
- User → Colab Training Pipeline: generates script