🌐 Live site & Vantage Cloud waitlist

⛰ Vantage

The offline-first command center for your codebase.

Turn any repository into an interactive knowledge graph, get instant git intelligence (bus-factor, churn, contributors), run a security & quality scan (secrets, complexity hotspots, dead code), and unlock local-AI superpowers — all from a single beautiful CLI. No data leaves your machine unless you opt in.

✨ Why Vantage?

• 🧭 Interactive knowledge graph — see how every file connects at a glance (vantage map).
• 📈 Git intelligence — bus-factor, churn hotspots, contributor breakdown, repo age.
• 🛡 Security & quality scan — detect leaked secrets, complexity bombs, TODOs, dead code.
• 🤖 Optional AI, your way — runs on local Ollama or any OpenAI-compatible API. No vendor lock-in.
• 🪶 Zero-config, zero-core-deps — a single pip install and you're ready. Core uses only the standard library + Rich.
• 🔒 Private by default — everything runs locally. Your code never touches a server.

🚀 Install

# From PyPI (recommended) — distributed as `maplens`, run as `vantage`
pip install maplens

# Or straight from the repo
pip install git+https://github.com/androvonx95/vantage.git

# Arch Linux (AUR)
yay -S vantage-git

That's it — the core has no required dependencies beyond rich.

The PyPI package is named maplens (the vantage name is taken on PyPI); the CLI command and import remain vantage.

Want the optional AI networking niceties? Append [ai]: pip install "maplens[ai]"

🖥 Usage

vantage                 # launch the dashboard (overview)
vantage insights        # git intelligence + repo insights
vantage scan            # security & quality scan
vantage score           # codebase health score (0-100) + breakdown
vantage map             # generate interactive HTML knowledge graph
vantage ai setup        # configure local AI (Ollama by default)
vantage ai doc file.py  # AI summarizes a file
vantage ai test file.py # AI writes tests for a file
vantage ai review -     # AI reviews a diff from stdin
vantage ai pr -         # AI writes a PR description from a diff
vantage doctor          # environment check

📛 Ignoring paths

Drop a .vantageignore file (gitignore-style globs) in your repo to skip files/dirs from scanning and graph-building — handy for excluding test fixtures or generated code.

Example: the knowledge graph

vantage map
# => Interactive map written to ./vantage-map.html (312 nodes, 540 edges)

Open the HTML in any browser. Search to filter, click nodes to inspect, drag to explore.

(Screenshot of a Vantage knowledge graph — thousands of files, instantly navigable.)

🤖 AI features (optional)

Vantage's AI layer works offline-first:

# 1. Install Ollama and pull a model
ollama pull llama3.1

# 2. Point Vantage at it
vantage ai setup        # choose "ollama", defaults just work

# 3. Use it
vantage ai explain - < messy.py
git diff | vantage ai review -

Prefer a cloud model? setup also supports any OpenAI-compatible endpoint (set VANTAGE_AI_KEY, VANTAGE_AI_BASE, VANTAGE_AI_MODEL).

🧩 How it works

Vantage classifies source files by extension, extracts symbols with the Python ast module (and a robust regex extractor for JS/TS/Go/Rust/Java/C#/Ruby/…), resolves import edges best-effort, and renders a force-directed graph with vis-network.

🗺 Roadmap

• Symbol-level graph (functions/classes as nodes)
• Architecture diagram export (Mermaid / SVG)
• Historical churn heatmap over time
• vantage serve — local web dashboard
• Team features & Vantage Cloud (continuous monitoring, alerts)

💸 Monetization & sponsorship

Vantage core is and will stay free & open-source (MIT). The project is funded by:

• ❤️ GitHub Sponsors — back the maintainers, get your name in the README.
• ☁️ Vantage Cloud (planned) — a hosted companion for teams that want continuous codebase monitoring, drift alerts, and shared configs across repositories. The local CLI remains the source of truth.

If Vantage saves you time (or embarrassment from a leaked key), consider sponsoring ⭐ and starring the repo.

📜 License

MIT © Vantage Contributors

Built with ⛰ and a lot of ast.