The AI-Native Engineering Intelligence Platform
From messy codebases to instant clarity — for MSPs, dev teams, and the engineers who keep everything running.
[ 🔍 Overview ·
Individual AI tools are powerful — but used in isolation, without governance, without codebase context, and without a unified commercial model, they create more chaos than value at enterprise scale.
💡 Studies estimate developers spend 2–3 hours per week context-switching between AI tools and re-explaining their codebase. At a fully-loaded cost of $80–$120/hour, that's $640–$1,440 of wasted productivity per developer per month.
Flux — Engineering Intelligence replaces tool sprawl with a single governed environment — combining deep engineering intelligence with general-purpose AI access, agent orchestration, and enterprise-grade security.
┌─────────────────────────────────────────────────────────────────┐
│ Flux — Engineering Intelligence │
│ │
│ ┌──────────────────┐ ┌──────────────────┐ ┌───────────────┐ │
│ │ 🔍 Ask Flux │ │ 🌐 Secure AI Hub │ │ 🤖 SDLC Agents│ │
│ │ │ │ │ │ │ │
│ │ Codebase Q&A │ │ ChatGPT │ │ Researcher │ │
│ │ iTroubleshooting │ │ Claude │ │ Product Owner │ │
│ │ Architecture │ │ Gemini │ │ Developer │ │
│ │ Diagrams │ │ Ollama (local) │ │ Tech Lead │ │
│ │ Auto Docs │ │ AI Council │ │ Tester │ │
│ │ Test Generation │ │ Agent Builder │ │ │ │
│ └──────────────────┘ └──────────────────┘ └───────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Security & Governance Layer │ │
│ │ Full Audit Trail · SSO (SAML/LDAP/OIDC) · IC Budgets │ │
│ │ Data Residency Choice · Role-Based Access · ANZ Compliant│ │
│ └──────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ Data & Intelligence Layer │ │
│ │ Postgres + pgvector · Codebase Index · Meilisearch │ │
│ │ Git/ZIP Ingestion · Confluence · Jira · Local Files │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
5 capabilities shipping today · 14 in the proposed MVP
|
👩💻 Individual Developer
🧑💼 Engineering Manager
⚙️ CTO / VP Engineering
|
🛡️ Security & Compliance
💰 CFO / Finance
🏢 MSPs & L2/L3 Support Teams
|
These are excellent tools. Flux — Engineering Intelligence is not a replacement — it is the governance, integration, and codebase-intelligence layer that makes them safe and scalable to use across an engineering organisation.
Cost comparison — 50 developers
| Stack | Monthly Cost | Governance | Codebase Memory | Audit Trail |
|---|---|---|---|---|
| Cursor + Claude Pro + Copilot | ~$3,950 | ❌ | ❌ | ❌ |
| Flux — EI Developer tier | ~$1,450 | ✅ | ✅ | ✅ |
| Flux — EI Professional tier | ~$4,950 | ✅ | ✅ | ✅ + SSO + SLA |
| Requirement | Version | Notes |
|---|---|---|
| Python | 3.10+ (3.12+ recommended) | FastAPI backend |
| Node.js | 20+ LTS | Vite frontend |
| Git | current | Clone / updates |
| Docker (optional) | current | Production deploy, Postgres, Ollama |
LLM access — pick at least one:
| Provider | Key | Notes |
|---|---|---|
| Anthropic (Claude) | ANTHROPIC_API_KEY |
Recommended |
| OpenAI | OPENAI_API_KEY |
GPT-4o, GPT-4o-mini |
| Google AI Studio (Gemini) | GOOGLE_API_KEY |
Flash, Pro |
| Azure OpenAI | Keys + endpoint in .env |
ANZ region available |
| Ollama | No key needed | LLM_PROVIDER=ollama — fully local, data-sovereign |
# 1. Clone
git clone <repository-url> flux && cd flux
# 2. Configure
cp backend/.env.example backend/.env
# Edit backend/.env — set at least one LLM API key
# 3. Start
chmod +x start.sh && ./start.sh| URL | Service |
|---|---|
| http://localhost:5173 | Frontend (Vite) |
| http://localhost:8000 | API |
| http://localhost:8000/docs | OpenAPI / Swagger |
# Stop everything
./stop.sh
# Keep services running across restart
./stop.sh --keep-postgres
./stop.sh --keep-ollama| Method | Best for | Frontend | API | Setup |
|---|---|---|---|---|
./start.sh |
Dev, fast hot-reload | :5173 |
:8000 |
~2 min |
| Docker Compose | Production, demos | :8080 |
:8080/api |
~5 min |
| Dev Container | Team onboarding | :5173 |
:8000 |
~3 min |
docker compose up --build -d
# Open http://localhost:8080cp backend/.env.docker.example backend/.env
docker compose --profile deps up -d --build
docker exec -it flux-backend python scripts/apply_postgres_schema.pycp fluxchat.env.example fluxchat.env
# Edit fluxchat.env — set JWT_SECRET, JWT_REFRESH_SECRET, OIDC secrets
docker compose --profile fluxchat up -d
# Open http://localhost:8080 → General ChatFull FluxChat docs: docs/FLUXCHAT.md
- Open repo in VS Code or Cursor
Cmd/Ctrl + Shift + P→ Dev Containers: Reopen in Container- Edit
backend/.env, then./start.sh
# Terminal 1 — Backend
cd backend
python3 -m pip install -r requirements.txt
python3 -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
# Terminal 2 — Frontend
cd frontend
npm install && npm run devmacOS
brew install python@3.12 node git
git clone <repo-url> flux && cd flux
cd backend && cp .env.example .env # add your LLM key
cd .. && chmod +x start.sh && ./start.shWindows
winget install Python.Python.3.12 OpenJS.NodeJS.LTS Git.Git
# Then in Git Bash:
cd backend && cp .env.example .env
cd .. && ./start.shPowerShell alternative: use the Manual Start with py -m pip / py -m uvicorn.
Ubuntu / Debian
sudo apt update && sudo apt install -y python3 python3-pip python3-venv git curl
# Install Node 20+ via nvm:
nvm install 20 && nvm use 20
git clone <repo-url> flux && cd flux
cd backend && cp .env.example .env
cd .. && chmod +x start.sh && ./start.shPostgreSQL + pgvector (optional)
# Add to backend/.env
DATABASE_URL=postgresql://flux:flux@127.0.0.1:5432/flux
# Start Postgres container and apply schema
docker compose --profile deps up -d postgres
cd backend && python3 scripts/apply_postgres_schema.py
# Migrate existing SQLite data (if any)
python3 scripts/migrate_sqlite_to_postgres.pyFull guide: docs/POSTGRES_SETUP.md
# From the repository root
NODE_OPTIONS="--max-old-space-size=4096" npm run build --workspace=frontendNote: If you encounter missing packages, run
npm cifrom the repository root first — this performs a clean install frompackage-lock.jsonand fixes any partial installs.
| Variable | Local dev | Docker Compose | Dev Container |
|---|---|---|---|
DATABASE_URL |
...@127.0.0.1:5432/... |
...@postgres:5432/... |
...@host.docker.internal:5432/... |
OLLAMA_BASE_URL |
http://127.0.0.1:11434 |
http://ollama:11434 |
http://host.docker.internal:11434 |
VITE_DEV_API_PROXY |
http://127.0.0.1:8000 |
— | http://127.0.0.1:8000 |
| Port | Service |
|---|---|
| 5173 | Vite dev server (local / dev container) |
| 8000 | FastAPI backend (local / dev container) |
| 8080 | nginx (Docker production stack) |
| 5432 | PostgreSQL (profile deps) |
| 11434 | Ollama (profile deps) |
graph TB
Browser["🌐 Browser"]
subgraph FLUX ["Flux — Engineering Intelligence"]
direction TB
subgraph UI ["Frontend — React + Vite"]
AskFlux["🔍 Ask Flux UI"]
FluxChat["🌐 Secure AI Hub\n(FluxChat)"]
SDLCUI["🤖 SDLC Agent UI"]
end
subgraph API ["Backend — FastAPI"]
Ingest["📥 Ingest\n(Git / ZIP)"]
ChatAPI["💬 Chat API"]
DiagramAPI["📐 Diagram API"]
DocsAPI["📄 Docs API"]
TestAPI["🧪 Test API"]
Orch["🎯 Orchestrator\n(SDLC Agents)"]
end
subgraph DATA ["Data Layer"]
SQLite["🗄️ SQLite\n(default)"]
PG["🐘 Postgres\n+ pgvector"]
FS["📁 File Store\n(projects/)"]
Meili["🔍 Meilisearch"]
end
end
subgraph LLMs ["LLM Providers"]
Claude["Anthropic\nClaude"]
OAI["OpenAI\nGPT-4o"]
Gemini["Google\nGemini"]
Ollama["🏠 Ollama\n(local / on-prem)"]
end
subgraph Sources ["Code Sources"]
GitHub["GitHub / GitLab"]
ZIP["ZIP Upload"]
Confluence["Confluence / Jira"]
PDFs["Local PDFs / Docs"]
end
Browser --> UI
UI --> API
API --> DATA
API --> LLMs
Sources --> Ingest
Ingest --> DATA
flux/
├── backend/
│ ├── app/
│ │ ├── main.py # FastAPI entry point
│ │ ├── config.py # Settings (reads .env)
│ │ ├── routers/ # API routes — ingest, chat, docs, diagrams, tests
│ │ └── services/ # LLM clients, parsing, orchestrator, indexing
│ ├── db/postgres/schema.sql # Postgres + pgvector DDL
│ ├── scripts/ # DB setup, migration, verification
│ ├── data/ # SQLite (flux.db) + backups
│ ├── requirements.txt
│ └── .env.example
├── frontend/
│ ├── src/ # React + TypeScript source
│ ├── package.json
│ └── vite.config.js # Vite build (mermaid IIFE fix, chunk strategy)
├── fluxchat/ # Secure AI Hub — LibreChat-derived submodule
│ └── client/ # FluxChat React frontend
├── docs/
│ ├── images/ # Icons and graphics used in README
│ ├── architecture/ # Platform + data architecture docs
│ ├── FLUXCHAT.md # Secure AI Hub architecture
│ ├── FLUXCHAT_MODE_A.md # Mode A pilot guide
│ ├── FLUXCHAT_HARDENING.md # Security hardening phases
│ ├── FLUX_EDGE_SECURITY.md # nginx rate limits, audit, edge security
│ └── POSTGRES_SETUP.md # DATABASE_URL, schema, migration
├── docker-compose.yml # Web + API; profile deps: Postgres + Ollama; profile fluxchat
├── .devcontainer/ # VS Code / Cursor dev container
├── start.sh # Dev: backend + frontend + optional Docker services
├── stop.sh # Stop all processes + optional Docker services
└── deploy.sh # Production Docker stack
| Container path | Host mount | Purpose |
|---|---|---|
/app/backend/data |
./backend/data |
SQLite, backups, uploads |
/app/backend/projects |
./backend/projects |
Indexed codebases, generations |
/var/lib/postgresql/data |
flux_pgdata (named) |
Postgres data |
/root/.ollama |
ollama_data (named) |
Ollama models |
The API image runs as non-root (
uid 1000). If bind-mounted directories are unwritable:sudo chown -R 1000:1000 backend/data backend/projects
Edit backend/.env. See backend/.env.example for all options and comments.
# Pick one (or more — Flux supports runtime switching)
LLM_PROVIDER=anthropic # or openai / google / azure / ollama
ANTHROPIC_API_KEY=sk-...
OPENAI_API_KEY=sk-...
GOOGLE_API_KEY=AI...# IANA timezone name — default is NZ
APP_TIMEZONE=Pacific/Auckland # NZST/NZDT (default)
APP_TIMEZONE=Australia/Sydney # AEST/AEDT
APP_TIMEZONE=UTCOverride without restart via Mission Control → Settings. All storage uses UTC internally.
AZURE_OPENAI_REGION=australiaeast| Region | GPT-4o per 1M tokens (in/out) | Notes |
|---|---|---|
australiaeast |
$2.75 / $11.00 | ~10% premium over US |
eastus |
$2.50 / $10.00 | Baseline |
westeurope |
$2.625 / $10.50 | ~5% premium |
View live pricing: GET /api/admin/pricing
M0 ──────────── M3 ──────────── M9 ──────────── M14 ────────── M18+
│ │ │ │ │
◉ Start ◉ OSS Release ◉ SaaS Beta ◉ SaaS GA ◉ Investor Ready
│ │ │ │
│ Phase 1 │ Phase 2 │ Phase 3 │ Future
│ Foundation │ SaaS Build │ Enterprise │ Platform
│ │ │ │
│ • Codebase │ • Full feat. │ • SAML/LDAP │ • Agent marketplace
│ cleanup │ set + SSO │ SSO │ • AIOps integrations
│ • CI/CD │ • Stripe │ • SOC 2 cert. │ • Reseller programme
│ hardening │ billing │ • GPU Ollama │ • Series A readiness
│ • OSS licence │ • ITSM conn. │ hosting │ • 1,000+ users
│ • Community │ • Admin dash │ • White-label │ • APAC + US expansion
│ docs │ • 250 users │ option │
│ • FluxChat │ │ • 3 enterprise │
│ standalone │ │ contracts │
| Phase | Timeline | Target |
|---|---|---|
| Phase 1 — Foundation | Months 1–3 | OSS release, Community + Developer launch |
| Phase 2 — SaaS Build | Months 4–8 | 250 paying users, Professional tier |
| Phase 3 — Enterprise | Month 9–14 | First 3 enterprise contracts, SOC 2 |
| Future — Platform | Month 18+ | 1,000 users, agent marketplace, Series A |
Intelligence Credit (IC) System — every AI action has a defined credit cost. Org admins set budgets, monitor consumption in real time, and hard-cap expensive model usage. No surprise bills — AI spend works like SaaS licensing.
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/ingest/git |
Clone & index a git repo |
POST |
/api/ingest/zip |
Upload & index a ZIP file |
GET |
/api/projects/ |
List all projects |
POST |
/api/chat/ |
Stream a chat response |
POST |
/api/docs/generate |
Generate documentation |
POST |
/api/diagram/generate |
Generate Mermaid diagram |
POST |
/api/tests/generate |
Generate unit tests for a file |
GET |
/api/health/postgres |
Postgres connection health |
GET |
/api/admin/pricing |
Current LLM pricing by region |
GET |
/api/ui/timezone |
Current timezone setting |
Full interactive docs: http://localhost:8000/docs when the backend is running.
Flux is MIT-licensed and open source. Contributions are welcome.
- Fork the repo and create a feature branch
- Make your changes — include tests where applicable
- Open a pull request describing what you changed and why
MIT — see LICENSE.
Flux — Engineering Intelligence · Production-proven · Architecturally sound · Built for the engineers who keep everything running.
Overview · Problem · Solution · Features · Get Started · Architecture · Roadmap