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 graph . --focus service.py       # Mermaid of the code around one file; -f svg for a drawing
dev explain cart.py                  # one file from novice to executive, every statement cited
dev docs . --audience principal      # documentation for architects, with provenance
dev mentor                           # advice only on failures that repeat across Ananke runs
dev spec trace specs/feature.md      # each requirement linked to the code and tests that meet it
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 serve                            # a local web interface: live runs, the code graph, your capabilities
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")

In your browser

dev serve opens a web interface to what Ananke computes. It shows what's connected, starts and follows runs (which survive a reload or a lost connection, and stop only when you press Cancel), browses the code graph, and searches your capabilities. It listens only on your computer, only the link it prints gets in, and it needs no Node: everything comes from the Dev Guru package on PyPI. See The local gateway.

What's released and what's coming next is in the roadmap.

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 journeys
make web-journeys       # just the web interface, in real Chrome, on a temporary workspace
make scan               # gitleaks, pip-audit, GuardDog and Bandit on dist/

Licence

Apache-2.0. See LICENSE.