Dev Guru

See your code. Understand it. Change it with confidence.

Point Dev Guru at a Python project and get one offline HTML explorer:

• a 3D constellation of files you can orbit, where imports pull and packages cluster;
• the flow of dependencies;
• the blast radius of a change;
• who calls what, and where the hotspots are;
• a guided tour, with the source one click away.

Everything is computed locally by Ananke Plexus, and the report is a single file you can share like a PDF.

pip install dev-guru
dev explore path/to/project -o explorer.html --open

Documentation and a live demo → · Dev Guru on PyPI →: the site's hero runs the real report of Dev Guru exploring its own source.

What's in a report

Plus search (/), a command palette (Ctrl/⌘ K), a source inspector, a light and dark theme, and shareable URLs. Reports are offline and view-only, treat source as text, and carry a manifest with the input digest and the Git revision. See report safety.

More than the explorer

dev present talk.md                  # Markdown slides → one offline, accessible HTML deck
dev diagram docs/arch.md             # an animated SVG of what a document states, every edge cited
dev explore . --profile public       # a report safe to publish: no source, docstrings or Git revision
dev sources                          # capabilities from your folders, private Git and Dex Trove
dev learning review NAME             # review what Ananke learned before it becomes reusable

From Python

from dev_guru import GuruClient

with GuruClient(workspace="path/to/project") as guru:
    result = guru.explore()
    guru.export(result, output="explorer.html")

How it fits together

Dev Guru never analyses code itself: every domain operation goes through one client port to Ananke, and Dex is never required. See Architecture and How Dev Guru talks to Ananke.

Quality gates

make verify             # ruff, ruff format, strict mypy, pytest
make acceptance-wheel   # capability scenarios on the built wheel, including real-Chrome report journeys
make scan               # gitleaks, pip-audit, GuardDog and Bandit on dist/

Licence

Apache-2.0. See LICENSE.