End-to-end visibility from pull request to production. AI-powered code review, intelligent test generation, flaky test detection, and RCA—all in one control center.
📖 Documentation • 🚀 Quickstart • 🏗️ Architecture • 🛣️ Roadmap
Modern engineering teams need more than tools—they need a co-pilot. TraceFox automates the entire SDLC feedback loop:
✨ Ship with confidence
Automated PR reviews and deterministic test generation catch regressions before they land.
🔍 Reduce firefighting
Flaky test detection and root cause analysis summaries point engineers straight to the fix—not the symptom.
📊 Operate transparently
One mission-control UI surfaces pipeline health, quality gates, performance trends, and ML drift in real-time.
🚀 Built for production from day one
Cloud-native architecture, environment-driven config, built-in observability, and resilience primitives.
- Need: Standardized, opinionated quality gates across repos
- Get: Automated enforcement of best practices, flaky test dashboards, and compliance reporting
- Need: Unified visibility into test health and incident patterns
- Get: RCA-powered insights, per-repo quality trends, and actionable alerts
- Need: Rapid velocity without sacrificing reliability
- Get: End-to-end demo with simulators (no infra required) + one-command bootstrap
TraceFox Control Plane (v3)
├── API Gateway (FastAPI)
│ └── Webhook ingestion, PR events, health checks
├── Domain Services (Microservices)
│ ├── code_indexing — Repository metadata, graph prep
│ ├── review_engine — AI-powered code analysis
│ ├── test_generation — Deterministic test synthesis
│ ├── test_execution — Parallel execution harness
│ ├── rca_engine — Root cause intelligence
│ ├── learning_feedback — Feedback capture & scoring
│ ├── compliance — Standards & audit trail
│ └── ml — Drift detection heuristics
├── Shared Layer
│ ├── Event Bus (Redis)
│ ├── Persistence (PostgreSQL + SQLite)
│ ├── Embeddings & Graph (Qdrant + Neo4j)
│ └── Config, Observability, Resilience
└── Frontend (Next.js)
└── Mission-Control Dashboard (SWR + Toast notifications)
Each service is intentionally lightweight: swap simulators for real integrations (embedding pipelines, CI runners) without rewiring core logic.
1. Pull Request Created
↓
2. GitHub Webhook → API Gateway
↓
3. Code Review Engine (AI analysis, findings)
↓
4. Test Generation (coverage gaps, edge cases)
↓
5. Test Execution (parallel harness, flaky detection)
↓
6. RCA Summary (if failures detected)
↓
7. Findings Posted to PR (structured comments, quality gate)
↓
8. Metrics Aggregated in Dashboard
git clone https://github.com/Sohail-9/tracefox.git
cd tracefox
python -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
pip install -r requirements.txtcp .env.example .env
# Edit .env with your GitHub + AI model credentialsKey environment variables:
| Variable | Purpose | Example |
|---|---|---|
TRACEFOX_GITHUB__CLIENT_ID |
GitHub OAuth app | Ov1.xxxxx |
TRACEFOX_GITHUB__CLIENT_SECRET |
GitHub OAuth secret | (from app settings) |
TRACEFOX_AUTH__GITHUB__DEV_MODE |
Local stub login (dev only) | true |
TRACEFOX_REDIS__URL |
Redis endpoint | redis://localhost:6379 |
TRACEFOX_POSTGRES__URL |
Postgres connection | postgresql://... |
See docs/configuration.md for the full matrix.
# Bring up Postgres, Redis, Neo4j, Qdrant
docker compose up -d postgres redis neo4j qdrant
# Start the FastAPI backend
uvicorn services.api_gateway.main:app --reload --port 8000In a new terminal:
cd frontend
npm install
npm run devVisit http://localhost:3000 to explore the mission-control experience.
Tip: For local development without real GitHub OAuth, set
TRACEFOX_AUTH__GITHUB__DEV_MODE=trueand use the/auth/github/dev-loginendpoint.
| Task | Command |
|---|---|
| Run backend tests | python -m pytest |
| Run frontend tests | cd frontend && npm run test |
| Lint frontend | cd frontend && npm run lint |
| Format code | black services/ && npm --prefix frontend run format |
| Sample webhook payload | See docs/configuration.md or in-app uploader |
Main integration test: tests/test_api_gateway.py exercises the complete webhook → review → test generation → RCA path.
TraceFox uses a hierarchical config system: environment variables → config service → defaults.
All settings live behind the TRACEFOX_ prefix and are exposed via services/shared/config.py:
TRACEFOX_POSTGRES__* Connection pooling, statement limits, timeouts
TRACEFOX_REDIS__* Namespacing, TTLs, socket config
TRACEFOX_QDRANT__* Vector storage, replication schedules
TRACEFOX_NEO4J__* Graph persistence, driver options
TRACEFOX_RETRY__* Backoff strategy, max attempts, jitter
TRACEFOX_CIRCUIT_BREAKER__* Failure thresholds, half-open timeouts
TRACEFOX_AI_MODELS__* Model providers, temperature, context length
TRACEFOX_QUALITY__* Flaky thresholds, coverage minimums
TRACEFOX_OBSERVABILITY__* OTLP endpoints, sampling ratios, correlation IDs
💡 Settings are cached but reloadable via services.shared.config.reload_settings().
The frontend showcases:
- Pipeline Overview — Real-time stage visibility (webhook → review → tests → RCA)
- Operational Pulse — Live metrics: active PRs, test pass rate, flaky count
- Onboarding Checklist — First-time setup guidance (dismissible)
- Insights Hub — Tabbed views for findings, generated tests, RCA summaries
- Activity Feed — Toast-powered event timeline with drill-down
Every view is powered by SWR hooks that call the FastAPI gateway, with skeleton loading and error boundaries.
End-to-end storyline with simulators, resilience primitives, event bus, observability hooks, and production-ready architecture.
- Real integrations: embedding pipelines, CI runners (GitHub Actions, GitLab CI), model providers
- Contract testing and breaking-change detection
- Multi-repository dashboard (org-wide health)
- Secrets scanning integration
- Multi-tenant control planes with RBAC/SSO
- Advanced drift monitoring and anomaly detection
- Marketplace for custom review rules and test generators
- Slack/Teams integration with actionable notifications
- Kubernetes-native deployment (Helm charts)
python -m pytest tests/ -vcd frontend && npm run testThe main flow in tests/test_api_gateway.py exercises the complete SDLC pipeline to guard against regressions.
Questions, ideas, or integrations?
- 📚 docs/configuration.md — Configuration reference
- 🛠️ Open an Issue — Report bugs or request features
- 💬 TraceFox Slack — Join the community
- ✉️ hello@tracefox.ai — Partnerships, pilots, or investor inquiries
Backend
- FastAPI, Pydantic, SQLAlchemy
- PostgreSQL, Redis, Neo4j, Qdrant
- Observability: OpenTelemetry, Prometheus
Frontend
- Next.js 14+, React, TypeScript
- SWR for data fetching, Tailwind CSS for styling
- Toast notifications, Skeleton loading
Infrastructure
- Docker & Docker Compose for local dev
- Terraform for cloud deployment
- GitHub Actions for CI/CD
MIT License — see LICENSE for details.
Let's ship resilient software together. 🦊✨
Built with ❤️ by the TraceFox team