ArchHelix

Understand any codebase in seconds.

Architecture Intelligence tool that analyzes codebases and visually maps their structure, components, and dependencies.

Features • Quick Start • Benchmarks • Languages

---

🚀 Why ArchHelix?

Jumping into a new repository? Dealing with messy spaghetti code? ArchHelix instantly reverse-engineers the codebase into a beautiful, interactive dependency graph. Find orphaned nodes, analyze domain interactions, and map codebase DNA without reading thousands of lines of code.

Watch the Interactive UI Demo:

✨ Features

• Blazing Fast Analysis: Parses ASTs locally in milliseconds.
• Interactive Visual Graph: Pan, zoom, and explore a beautiful React-based dependency map.
• Polyglot Parsing: Understands structural DNA out-of-the-box (Go, Python + more coming).
• Embedded Web UI: No SaaS, no cloud, no friction. The UI is embedded directly into the single binary.
• Code Context Inspector: Click any node to instantly view the code and its exact dependencies.

⚡ Quick Start

ArchHelix is absurdly simple to set up. No complex configs or containers required.

1. Install (macOS / Linux)

curl -sL https://raw.githubusercontent.com/alexanderritik/ArchHelix/main/install.sh | bash

2. Run

Point it to any local path or remote Git repository:

archhelix clone https://github.com/user/repository.git

The UI will automatically open at http://localhost:8080/.

📊 Benchmarks

ArchHelix is built for speed, designed to handle large-scale enterprise repositories locally without breaking a sweat.

Project Size	Lines of Code	Analysis Time	Memory Usage
Small CLI	~10,000	< 50ms	~15 MB
Mid API	~100,000	< 300ms	~45 MB
Large Repo	~1,000,000	< 2.5s	~180 MB

(Note: Benchmarks performed on an Apple M1 Pro. Performance scales beautifully with available cores.)

🛠️ Supported Languages

• Go (Full AST Parsing, precise dependency mapping, ignores test files automatically)
• Python (AST Parsing, robust import resolution)
• TypeScript/JavaScript (Coming Soon)
• Java (Coming Soon)

📸 Screenshots

Click to view screenshots

Dependency Graph View

File Inspector

💻 Build From Source

Want to hack on ArchHelix?

# Clone the repository
git clone https://github.com/alexanderritik/ArchHelix
cd archhelix

# Build the Frontend Map (React)
cd ui
npm ci
npm run build
cd ..

# Build Go Binary
go build -o archhelix

# Run against a test repository
./archhelix clone <repository-url>

🤝 Contributing

We love contributions! Feel free to open issues, submit PRs, and help expand language support (e.g., TS/JS provider). Check out our open issues to get started.

📄 License

This project is licensed under the MIT License.