CommitIQ analyzes a repository's commit history and turns raw engineering activity into actionable maintainability signals: complexity, churn, dependency risk, semantic drift, ownership concentration, and AI-generated commit narratives.
Most GitHub dashboards show activity. CommitIQ focuses on code health. It helps developers and maintainers answer critical questions:
- Which files are becoming risky over time?
- Where is churn hiding architectural debt?
- Which parts of the repo depend too heavily on one contributor?
- What changed across a period of commits, in plain English?
- Which hotspots deserve review before the next release?
Try the live application: https://commit-iq-iota.vercel.app
- Holistic Health Timelines: Built from complexity, churn, dependency, semantic, and ownership signals.
- Architectural Discovery: Import and co-change graph exploration for architectural risk discovery.
- Risk Dashboards: Hotspot and bus-factor views for maintainability and ownership risk.
- AI Narratives: Claude/Gemini-generated narratives with cache, budget controls, and demo fallbacks.
- Enterprise-Grade CI/CD: Covered by Pytest, Vitest, CodeQL Security Scanning, Codecov, and strict pre-commit hooks.
- Beautiful UI: Light/dark React dashboard with Vite, SWR, Recharts, and Force Graph tooling.
| Area | Stack |
|---|---|
| Backend | FastAPI, SQLAlchemy Async ORM, SQLite (default) / Postgres |
| Analysis | GitPython, git subprocesses, radon, lizard, custom graphs |
| Semantic Drift | difflib fallback, GraphCodeBERT (optional) |
| AI Layer | Anthropic Claude, Google Gemini fallback |
| Frontend | React, TypeScript, Vite, SWR, Recharts, react-force-graph-2d |
| Quality | Pytest, Vitest, ESLint, CodeQL, Codecov, Pre-commit, Playwright |
git clone https://github.com/eshaanag/CommitIQ.git
cd CommitIQcp .env.example .env
python -m venv .venv
source .venv/bin/activate
pip install -r backend/requirements.txt
uvicorn backend.main:app --reload --host 0.0.0.0 --port 8000cd frontend
cp .env.example .env
npm install
npm run devThe frontend runs at http://localhost:5173.
We welcome contributions! Please see our Contributing Guide for details on setting up your environment, running tests, and our pull request process.
Before pushing, please ensure you have our pre-commit hooks installed:
pip install pre-commit
pre-commit installThanks goes to these wonderful people who have contributed to CommitIQ:
 Eshaan Agrawal 💻 🎨 |
 Pratham Reddy 💻 |
 Aditya Yadav 💻 |
- PROJECT_BRAIN.md - Architecture, decisions, risks, and history.
- REPO_HEALTH_METRICS.md - Health signals and metrics design.
- SECURITY.md - Vulnerability reporting and operator security.
This project is licensed under the MIT License.