codetopo / README.md
ataimlds's picture
Upload 2 files
fb36d81 verified
|
Raw History Blame Contribute Delete
2.27 kB
---
title: codetopo — Agent-Friendly Topology
short_description: Agent-friendly topology — code graphs for AI agents
emoji: 🕸️
colorFrom: purple
colorTo: blue
sdk: static
app_file: index.html
pinned: false
---
# codetopo — agent-friendly topology
codetopo builds the **graph of a codebase** — files, imports, calls,
dependencies — and answers questions about its shape:
- **Rank** — blast radius, PageRank, betweenness, closeness,
eigenvector and Katz centrality: what matters, and what breaks.
- **Topological sort** — a build/reading order, with cycles reported
honestly as cyclic groups instead of being silently hidden.
- **Communities** — the clusters the graph actually forms.
- **Render** — the graph as data or as an SVG picture.
It sells on three surfaces: a **hosted API**
(`codetopo-api.aimlds.org`), a **CLI**, and an **MCP server** (listed on
the Official MCP Registry). Plans: Free · Team US$19/mo ·
Guardrails US$49/mo (limits and current pricing are confirmed on the
product site). Service status: https://codetopo.aimlds.org/status
## What this Space does
A working demo of the idea, at Hugging Face scale, on a **static page**:
give it any **public model repo id** (the default is a small Qwen model)
and the page fetches the repo's file list from the Hugging Face API —
directly from your browser, no server in between — and renders its
**topology**: a tree plus a grouped summary of what the repo is made of
(weights, config, tokenizer, docs, code, other — with counts and sizes).
No API key is used, and only public repos are read. Unlike the Gradio
edition of this Space, this static page does not itself run an MCP
server; codetopo's MCP server is the production one, listed on the
Official MCP Registry.
For real codebases — your own repositories, private indexes, the full
query set — use production codetopo through its API, CLI, or MCP
server.
---
A product of **2351485 ALBERTA INC.** (AIMLDS) — https://aimlds.org
<!-- DRAFT static Space pack — not yet published. Alternate to the Gradio
pack in ../../spaces/codetopo/ (HF gates Gradio Spaces behind PRO;
static Spaces are free). See ../../GAPS.md for the facts to
re-verify (including tier pricing) before publishing. -->