Graqle

Install

Config snippet generator goes here (5 client tabs)

README

<div align="center">

<!-- HERO: The 5-second hook -->
<!-- GitHub renders the animated SVG via <picture>. PyPI falls back to the <img> PNG. -->

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/hero-dark.svg" type="image/svg+xml">
  <source media="(prefers-color-scheme: light)" srcset="assets/hero-dark.svg" type="image/svg+xml">
  <img alt="GraQle — Your AI reads files. GraQle reads architecture." src="https://raw.githubusercontent.com/quantamixsol/graqle/master/assets/hero-dark-hq.png" width="800">
</picture>

# Your AI reads files. Gra**Q**le reads architecture.

**The context layer for AI coding agents.** Scan any codebase into a knowledge graph.
Every module becomes an agent. Ask questions — get architecture-aware answers in 5 seconds, not 2 minutes.

[![PyPI](https://img.shields.io/pypi/v/graqle?color=%2306b6d4&label=PyPI)](https://pypi.org/project/graqle/)
[![Downloads](https://img.shields.io/pypi/dw/graqle?color=%2306b6d4&label=downloads%2Fweek)](https://pypi.org/project/graqle/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-06b6d4.svg)](https://python.org)
[![Tests: 1,900+](https://img.shields.io/badge/tests-1%2C900%2B%20passing-06b6d4.svg)]()
[![LLM Backends: 14](https://img.shields.io/badge/LLM%20backends-14-06b6d4.svg)]()
[![MCP Tools: 27](https://img.shields.io/badge/MCP%20tools-27-06b6d4.svg)]()

```bash
pip install graqle && graq scan repo . && graq run "what's the riskiest file to change?"
```

[Website](https://graqle.com) · [Dashboard](https://graqle.com/dashboard) · [PyPI](https://pypi.org/project/graqle/) · [Changelog](CHANGELOG.md)

</div>

---

## 50,000 tokens → 500 tokens. Same answer.

| | Without GraQle | With GraQle |
|:--|:--|:--|
| **"What depends on auth?"** | AI reads 60 files, guesses | Graph traversal → exact answer in 5s |
| **Tokens per question** | 50,000 | **500** |
| **Cost per question** | ~$0.15 | **~$0.0003** |
| **Impact analysis** | Manual grep + hope | `graq impact auth.py` → full blast radius |
| **Memory across sessions** | Lost when chat resets | Persistent knowledge graph |
| **Confidence in answers** | "I think..." | **Confidence score + evidence chain** |

> *"We scanned 17,418 nodes across 3 projects in one session. Found 807 jargon blind spots,
> 218 ghost UI elements, and a CTA that was 20px tall (44px minimum). Cost: $0.30."*
> — [Quantamix Website Audit](https://graqle.com)

---

## How it works — 60 seconds

```bash
# 1. Install
pip install graqle

# 2. Scan your codebase into a knowledge graph
graq scan repo .
# → 2,847 nodes, 9,156 edges — your entire architecture mapped

# 3. Ask anything about your architecture
graq run "explain the payment flow end to end"
# → Graph-of-agents activates 8 relevant nodes, synthesizes answer
# → Confidence: 92% | Cost: $0.001 | Time: 5.2s

# 4. Connect to your AI IDE (zero config change)
graq init          # Claude Code, Cursor, VS Code, Windsurf — auto-detected
```

Your AI now has **27 architecture-aware MCP tools** — including Phantom computer skills for live browser automation. No workflow change — it uses them automatically.

---

## What makes Graqle different

<table>
<tr>
<td width="50%">

### 🔬 Graph-of-Agents Reasoning

Every module in your codebase becomes an autonomous agent. When you ask a question, only the relevant agents activate — they debate, exchange evidence, and synthesize one answer with a confidence score and full audit trail.

This is not RAG. This is **structured multi-agent reasoning over your dependency graph.**

</td>
<td width="50%">

### 🧠 The Graph Learns

```bash
graq learn "auth requires refresh token rotation"
graq grow            # Auto-runs on git commit
```

Every interaction makes the graph smarter. Lessons persist across sessions. New developers and AI tools inherit your team's institutional knowledge automatically.

</td>
</tr>
<tr>
<td>

### 🛡️ Governed AI Decisions

```bash
graq preflight "refactor the database layer"
# → 4 modules depend on connection pool
# → 2 have no tests
# → DRACE score: 0.72 (proceed with caution)
```

Every answer is auditable. DRACE governance scores across 5 dimensions. Full evidence chains. Patent-protected.

</td>
<td>

### ⚡ 14 LLM Backends

```yaml
model:
  backend: ollama    # Free, offline, air-gapped
  # Also: anthropic, openai, groq, deepseek,
  # gemini, bedrock, together, mistral,
  # fireworks, cohere, openrouter, vllm, custom
```

Use your own API keys. Run fully offline with Ollama. Smart routing assigns different models to different tasks.

</td>
</tr>
</table>

---

## Real stories from production

<details>
<summary><b>📊 "807 jargon blind spots in 90 seconds"</b> — Website audit with SCORCH</summary>

A professional website with WCAG AAA compliance still had 807 unexplained acronyms (TAMR+, TRACE, SHACL, HashGNN) that compliance officers would bounce on. GraQle's SCORCH engine found them all in one scan. Lighthouse missed every one.

**Before:** "Explore our TAMR+ SHACL-compliant governance pip