N3mo

A structural code intelligence layer that transforms source code into a queryable knowledge graph for search, impact analysis, and AI-powered development.

*Parse once. Query forever. Know exactly what breaks before it does.*

*"Text diffs are the source of all code review anxiety. A developer modifies a core utility, and the reviewer has to spend an hour mentally tracing downstream services to guess if it's safe to merge. N3MO replaces human guesswork with hard math."*

[Deploy the GitHub Webhook Instantly at n3mo.shop →](https://n3mo.shop)

📜 Licensed under PolyForm Noncommercial 1.0.0 — Source available for noncommercial use. • Need commercial use? Get a commercial license →

What is N3MO • Capabilities • Installation • Usage • MCP • CI/CD SaaS • Benchmarks • Tutorial • Sponsor

---

🎯 What is N3MO?

N3MO is a symbol-centric code intelligence layer. Instead of scanning raw text, it parses your source code's ASTs, maps call graphs, and models dependencies in a queryable relational database — deterministically, with zero LLM calls at index time.

For engineering leaders and teams, N3MO acts as a structural insurance policy for your codebases.

💡 Why N3MO?

• 🛡️ Eliminate Regression Risks — Utility functions are rarely refactored because developers fear unknown side effects. N3MO maps the transitive blast radius of any symbol to arbitrary depth, showing you exactly what will break before you make the edit. [Automate this in your CI/CD →](https://n3mo.shop)
• 🏎️ Rapid Developer Onboarding — Instead of senior engineers spending hours explaining codebase flow to new hires, developers run one command to visualize complex call chains and parent-child dependencies interactively.
• 🤖 AI-Agent Ready Infrastructure — Modern LLM agents (Cursor, Claude Desktop) are limited by context windows and text search. N3MO's native MCP server lets agents query the actual code graph, enabling fast, hallucination-free refactoring.
• ⚡ No Embeddings, No Drift — N3MO is pure static analysis: Tree-sitter AST parsing into PostgreSQL. There's no vector index to keep in sync, no embedding cost per repo, and no semantic-similarity guesswork — every edge in the graph is an exact, verifiable relationship.

📊 How N3MO Compares

🛠️ The Core Problem N3MO Solves

❌ Without N3MO

Developer: "Where does 'login' appear?" Tool: grep -r "login" . Result: 647 matches across 89 files ...now what?

✅ With N3MO

Developer: "What breaks if I change login?" Tool: n3mo impact "login" Result: 3 direct callers → 5 ripple effects Full blast radius in < 50ms

N3MO doesn't find text — it understands structure. It traces the actual call graph, not string matches.

Questions N3MO answers instantly:

---

👥 Who it's for

---

✨ Core Capabilities

Ingestion & Parsing

• Multi-language support — 27 Tree-sitter grammars supported (dynamically loaded); actively benchmarked on 10 major languages including Python, JS/TS, Go, Java, and C/C++
• Parallel AST ingestion — ProcessPoolExecutor distributes CPU-bound parsing across all available cores
• Incremental re-indexing — SHA-256 file hashing skips unchanged files automatically
• Idempotent operations — re-indexing updates existing data without duplication
• Smart exclusions — case-insensitive directory filters and camelCase-aware filename checks prevent false positives (e.g. allows contest.py while skipping test_*.py)

Analysis & Querying

• Symbol extraction — functions, classes, methods with full file path + line context
• Hierarchical modeling — parent-child relationships (Module → Class → Method)
• Call graph construction — who calls whom, resolved at ingestion time
• Scope-aware resolution — class scope > local file > imports > qualified dot paths > global
• Blast radius analysis — recursive CTE traversal to arbitrary depth with cycle guards

Performance

• Connection pooling — ThreadedConnectionPool eliminates per-symbol DB round trips
• Batch inserts — symbols, imports, and calls batched per file in single transactions
• Optimized queries — SPLIT_PART fix delivered a 2× speedup on call resolution

Visualization & Integration

• Interactive graph — vis.js orbit map with click-to-inspect nodes, sidebar, and depth slider
• Dark mode — toggleable canvas dark mode with real-time node/edge updates, persisted in localStorage
• Premium styling — sleek interactive dashboard landing page UI and graph visualizer styled with Bricolage Grotesque, Inter, and JetBrains Mono typography
• [SKILL.md](SKILL.md) profile — system instructions to configure Claude as an impact-aware coding agent
• Native MCP server — first-class integration with Cursor, Claude Desktop, and Windsurf
• Git hooks — automatic re-indexing on every commit
• CI pipeline — GitHub Actions with linting (ruff), type checking (mypy), and pytest

---

---

🌐 Supported Languages

Tree-sitter parsing supported for 27 languages. Deep semantic call graph mapping currently optimized for Python, JS/TS, and Java.

---

---

🚀 Installation

Prerequisites

Quick start

Install N3MO directly from PyPI:

# Install the package

pip install n3mo

Start Docker containers & initialize the database

n3mo setup

Alternatively, for contributors running in editable mode:

git clone https://github.com/RajX-dev/N3MO.git

cd N3MO pip install