Metadata-Version: 2.4
Name: ambitgraph
Version: 0.1.0
Summary: Read-only codebase scan: reusable units, families, roles, ownership candidates, duplication.
Author: AmbitGraph
License: Proprietary
Keywords: codebase,scan,audit,duplication,refactoring,reuse
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6
Provides-Extra: ui
Requires-Dist: playwright>=1.40; extra == "ui"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: mcp<2,>=1.2; extra == "dev"
Requires-Dist: jsonschema>=4; extra == "dev"
Provides-Extra: gate
Requires-Dist: mcp<2,>=1.2; extra == "gate"
Dynamic: license-file

# AmbitGraph

**You don't understand your own product!**

**You can't keep up with the amount of code!**

One command, and you do. Deterministic. No tokens.

AmbitGraph draws your whole repo as a visual interactive map & library and gives them to you. It needs Python on your machine, never in your project. Free, offline, no account, no API key.

Python 3.11 or newer.

## Install and run

```
pip install ambitgraph
python -m ambitgraph map <folder>
```

`ambit map <folder>` does the same when your Python scripts folder is on your PATH.

The command gives your terminal back and the map keeps serving. Stop it with `python -m ambitgraph map <folder> --stop`.

Your codebase is displayed in your browser as local webpages.

It does not make any changes to your codebase.

## A GRAPH

Modules, Classes, Imports, Calls, DB Tables, anything in your code mapped on its connections.

## An Indexed and Searchable LIBRARY

Understand what you have, what it does, and what it means.

Understand your own codebase in a way you never have. Simple, visual, and if you want more you can ask your agent what the hell it just did. A vibe coder can finally see how their code works. A senior can see at a glance when something has got too complicated.

## Your machine

The map is served to your own machine, stays on your machine. It and your code belong to you

## No AI

No AI is required. The map is plain reading of your code.

No model runs, no tokens burn, no key exists. If you want more than the map, your own assistant can work on top of it, on your own subscription, with whatever model you already pay for. Optional, always, and the map is finished without it.

## In this version

Search finds functions and tables by name. The Library groups every file the
scan read into families. The Graph draws one file and everything one hop from
it, and every row in the Library opens it.

Search does not find routes or file names. Drawn connections do not carry
their meaning beside them. There are no written explanation pages.
