Quantum-infused agentic marketing and finance copilot for budget orchestration, risk-aware scenario planning, and multi-agent decision intelligence.

qamf-copilot is a polyglot architecture for teams that want one autonomous system to coordinate marketing experimentation, campaign allocation, and finance-side risk posture with a hybrid quantum-classical reasoning layer.

• uses a quantum-style feature map and kernel scoring to detect nuanced customer and portfolio signals
• coordinates a team of specialized agents across strategy, creative, risk, and operations
• runs a causal what-if engine to estimate likely lift, drag, and variance before committing budget
• exposes a FastAPI control plane and a React command dashboard
• packages the broader platform as a serious multi-language repo with Rust, Go, Scala, Julia, Kotlin, Swift, SQL, and Kubernetes expansion surfaces

The fully verified runtime in this environment includes:

• Python decision engine in src/qamf_copilot
• FastAPI app in services/qamf_api/app/main.py
• React dashboard in frontend-dashboard/src/App.tsx
• tests, live API smoke, and browser screenshot capture in tests

qamf-copilot/
├── qml-models/            # quantum-inspired modeling surface
├── agent-orchestrator/    # Rust coordination layer
├── agents/                # strategy / creative / risk / ops agent docs
├── api-gateway/           # Go edge gateway
├── causal-engine/         # scenario and DAG modeling
├── frontend-dashboard/    # React + TypeScript command center
├── mobile/                # Kotlin / Swift executive companion stubs
├── data-pipeline/         # Scala historical processing surface
├── what-if-simulator/     # Julia scenario engine surface
├── kubernetes/            # Helm chart
├── sql/                   # event store and feature store assets
├── services/qamf_api/     # FastAPI control plane
└── src/qamf_copilot/      # verified Python core

• GET /health
• GET /api/overview
• GET /api/agents
• GET /api/segments
• GET /api/portfolio
• POST /api/what-if
• POST /api/train

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
npm --prefix frontend-dashboard install
python -m uvicorn services.qamf_api.app.main:app --host 127.0.0.1 --port 8022
npm --prefix frontend-dashboard run dev

python -m pytest tests -q
python -m compileall services src tests
npm --prefix frontend-dashboard run build

• Architecture
• Final audit
• Contributing
• Security policy
• Authors