Agent Q3
MAD Gambit β Multi-agent intelligence layer Contains both Agent Q3 [HQ] (production orchestration) and Agent Q3 [Evo] (self-improving research pipeline)
Variants
| Variant | Role | Key Tech |
|---|---|---|
| Agent Q3 [HQ] | Production orchestration | Tandem Core Β· ComputeRouter Β· LangGraph Β· MCP Β· Solidity audit |
| Agent Q3 [Evo] | Self-improving research | LoRA fine-tuning Β· arXiv ingestion Β· ChromaDB Β· Unsloth Β· benchmarks |
File Structure
Agent-Q3/
βββ README.md
β
βββ hq/ β Agent Q3 [HQ] β Production
β βββ Dockerfile
β βββ docker-compose.yml
β βββ requirements.txt
β βββ .env.example
β βββ orchestrator.py β FastAPI + ComputeRouter
β βββ compute_router.py β Multi-backend weighted routing
β βββ tandem_core.py β Gemma4 Reasoner + Qwen3.5 Coder chain
β βββ langgraph_graph.py β StateGraph agent orchestration
β βββ mcp_config.json β 14 MCP server connectors
β βββ litellm_config.yaml β LiteLLM routing config
β βββ metrics.py β Prometheus /metrics endpoint
β
βββ evo/ β Agent Q3 [Evo] β Research
β βββ Dockerfile
β βββ requirements.txt
β βββ .env.example
β βββ training_pipeline.py β Unsloth LoRA fine-tuning
β βββ arxiv_ingestor.py β arXiv fetch β chunk β embed
β βββ chromadb_store.py β Vector store (nomic-embed-text 384-dim)
β βββ feedback_collector.py β DPO/RLHF signal capture
β βββ benchmark_runner.py β Domain QA evaluation
β βββ lora_pusher.py β Push adapters to HF
β βββ langgraph_graph.py β StateGraph agent orchestration
β
βββ shared/ β Shared utilities
βββ auth.py
βββ logger.py
βββ config.py
HQ β Quick Start
cd hq
cp .env.example .env
docker compose up --build
Endpoints:
POST /v1/chatβ auto-classify β Reasoner or CoderPOST /v1/reasonβ force Gemma4-E4B (planning, research, audit)POST /v1/codeβ force Qwen3.5-4B (code, debug, file ops)POST /v1/tandemβ Gemma4 reasons β Qwen3.5 implementsGET /healthβ backend health + loaded modelsGET /metricsβ Prometheus metrics
Evo β Quick Start
cd evo
cp .env.example .env
pip install -r requirements.txt
python training_pipeline.py
Linked HF Assets
| Type | Label | Link |
|---|---|---|
| Model | Agent Q3 (unified) | madDegen/agent-q3-core |
| Dataset | Agent Q3 (unified) | madDegen/agent-q3 |
| Space | Agent Q3 (unified) | madDegen/agent-q3-space |
License
Apache 2.0