📡 Client / Frontend static/ · templates/ — served by Flask
🖥️ Single-Page App
static/app.js
~13k lines · workflows, Visual Designer, agents, connectors, admin
⚙️ PWA Shell
static/sw.js · manifest.json
Service worker cache cw-v9 · offline shell
🎨 Styling
static/style.css · themes.css
Dark/light themes · icons/ · logo.svg
📄 Jinja Shells
templates/*.html
2 server-rendered entry pages
▼ HTTPS · ingress → app.brainzbytes.com ▼
🧠 Application Core the controller — everything routes through here
app.py
Flask · gunicorn · port 5080
12,620 lines · 246 routes
agent 23
workflows 20
connectors 18
visual-designer 15
user/auth/groups 24
indexes 11
sources 10
designer 10
config 9
plugin-library 8
workspaces 8
engines 6
cluster 5
sim 4
+ pages 27
▼ delegates by domain ▼
🧩 Core Domain Modules top-level *.py — focused responsibilities
🤖 AI / Agent
agent.py · sim_mode.py
Agent loop, tool-calling · sim/offline mode
1,654565
⚡ Workflows
workflow_engine.py · scheduler.py
step engine · interpolation · cron scheduler
661184
🔌 Plugins / Connectors
connector_catalog · plugin_codegen
plugin_builder · plugin_resolver
Catalog, codegen, build & resolve plugins
1,77980872060
📚 RAG / Ingest
ingestor.py · source_validator.py
Crawl, chunk, embed & validate sources
580220
▼
🔗 Infrastructure Clients the only modules that talk to Azure
☁️ Azure Clients
azure_clients.py
Cosmos · AI Search · OpenAI · workload identity
319
🔐 Vault Client
vault_client.py
User-scoped credentials in Key Vault
366
🚀 Bootstrap
launch.py · config.json
Local entrypoint & runtime config
39
▼ persists / reads ▼
🗄️ Azure Data & AI Services always-on — external to the container
🪐 Cosmos DB
cw-cosmos-brainzbytes · db: cerebro
workflows · runs · designs · plugins · audit
🔎 AI Search
cw-search-brainzbytes
RAG vector + keyword index
🧠 Azure OpenAI
devpilotx-openai · gpt-5-chat
Chat + embeddings deployments
🔑 Key Vault · ACR
kv-brainzbytes · brainzbytes.azurecr.io
Secrets · container images
━━━━━━━━━━ separate control plane ━━━━━━━━━━
🛡️ Governance Platform platform/ — MCP engine control plane
⚙️ MCP Engine Operator
platform/mcpengine_operator/
K8s operator + admission webhook · CRDs
operator.pyvalidator.pycrds/
📋 Policy Engine
platform/policy_engine/
Rules, audit, identity · hard-block guardrails
engine.pyrules.pyaudit.py
🔀 Cross-Engine
platform/cross_engine/
Multi-engine orchestration & handoffs
invoker.pyresolver.pyworkflows.yaml
📊 Eval Harness
platform/eval_harness/
Per-engine eval cards · graduation · auto-pause
cards/identity/webhook_receiver/
▼ governs ▼
🔧 MCP Engines engines/ — per-vertical runtime, declared in AGENTS.md
🧱 Engine Base
engines/mcp-engine-base/
Shared MCP runtime (server.py + Dockerfile)
💳 Vertical Services
engines/credit-card-service · email-service
Example per-vertical engine implementations
📇 8 Declared Engines
AGENTS.md registry
sre · code · sfi · specs · dependency · pipeline · release · glue
━━━━━━━━━━ packaging & deploy ━━━━━━━━━━
📦 Build · Deploy · Infra packaging onto AKS
🐳 Docker
Dockerfile (+ workbench, code-server)
Builds cerebro-app image via ACR Tasks
⎈ Helm Charts
helm/
cerebro-app · mcp-engine · code-server · jupyterhub · monitoring · workbench
🔁 Pipelines
pipelines/
azure-pipelines.yaml (CI/CD id 7) · resource-control.yaml (id 8)
🏗️ Terraform · Docs
terraform/ · docs/ · notebooks/
1.3 GB IaC · architecture pages · guides