Skip to main content

Turn any codebase into a visual architecture wiki for humans and agents

Project description

Talocode ArchWiki

Turn any codebase into a visual architecture wiki for humans and agents.

What it does

Scans a repo, detects routes/services/auth/database/build patterns, and generates:

  • architecture.json — machine-readable graph for agents
  • architecture.html — interactive dark visual wiki for humans

Install

pip install talocode-archwiki

Usage

# Scan current directory
archwiki .

# Scan specific repo
archwiki /path/to/repo

# Specify output directory
archwiki /path/to/repo /path/to/output

Python SDK

from archwiki import scan

result = scan("/path/to/repo")
print(result["json"]["stats"])
# {"total_files": 86, "total_nodes": 31, "total_edges": 0, "total_flows": 2}

Output

architecture.json

Machine-readable graph with nodes, edges, and flows:

{
  "name": "my-app",
  "nodes": [
    {
      "id": "route_src/routes.ts",
      "name": "routes",
      "type": "route",
      "file": "src/routes.ts",
      "description": "route in routes.ts",
      "code_ref": "app.get('/api/users', ...)"
    }
  ],
  "flows": [
    {
      "id": "api_request",
      "name": "API Request",
      "steps": [...]
    }
  ]
}

architecture.html

Interactive dark visual wiki with:

  • Flow visualization (nodes + connections)
  • Right sidebar (Flows + Steps)
  • Click a node → see code reference
  • Click a flow → see numbered steps
  • Dark charcoal + gold accent design

Talocode ecosystem

Package Install
ArchWiki (this package) pip install talocode-archwiki
Wiki pip install talocode-wiki
DocuLane pip install talocode-doculane
CodeLane pip install talocode-codrane
XSearchLane npm i @talocode/xsearchlane
Tera pip install talocode-tera
Codra pip install talocode-codra
StackLane pip install talocode

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT © Talocode

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

talocode_archwiki-0.2.0.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

talocode_archwiki-0.2.0-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file talocode_archwiki-0.2.0.tar.gz.

File metadata

  • Download URL: talocode_archwiki-0.2.0.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for talocode_archwiki-0.2.0.tar.gz
Algorithm Hash digest
SHA256 1e8f90dc9bededd1ad570051f36065f7991d2e55fba2a73ed8e6f9e811436dd4
MD5 2fd21c87292dfc022a8bfe5ead8ac702
BLAKE2b-256 22e1674377131c68db955b99d249f6f2c816ef1cb520b5ae030af1e14e3bf54b

See more details on using hashes here.

File details

Details for the file talocode_archwiki-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for talocode_archwiki-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eb4f5572f58dd713e8dcc8fe216b05fcec285e7f2cf3d958f26446511af50d30
MD5 136d9f115122889e3e018133c32fdfb0
BLAKE2b-256 2999406b8018d5232e106fcff4bdaf02345da749ed790600880afd810dc4072a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page