A local-first AI architecture visualizer. Describe any system and watch it decompose into an interactive, drillable graph — or upload your existing codebase to visualize it.
Powered by Ollama (free, local AI). No API keys. No billing. No cloud.
Frontend: Vue 3 + Vite Backend: Express.js (TS) with integrated Ollama AI
- AI Decompose — describe any system, AI generates a multi-level architecture graph
- Hybrid Mode — AI generates the base, then edit/add/delete nodes inline
- Drill-down — click any node to zoom into its children; breadcrumb navigation back
- Syntax Toggle — hide code, show pseudocode, or show real implementation code
| Level | Depth | What you get |
|---|---|---|
| Beginner | 1 | High-level system overview |
| Intermediate | 2 | Subsystems + data flow |
| Advanced | 3 | Internal mechanisms, auth, protocols |
| Expert | 4 | Full implementation detail |
- 📝 README Generator — auto-generates a professional README from your architecture; turns red when stale
- 📁 File Structure — view the generated project's file tree
- 📦 Download ZIP — download everything (code, README, config) as a ready-to-use project
- 📤 Upload Codebase — upload a ZIP or source files to reverse-engineer into a flowchart
- 🗺️ Minimap — birds-eye view of the full graph
- 🔎 Zoom Controls — zoom in/out and fit-to-view
- Persistent state — refresh the page and everything is still there (localStorage)
- Prompt history — quickly re-run recent prompts
- Error handling — clear error messages with dismiss button
- No overlap — tree-aware layout allocates space proportionally
# 1. Install Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 2. Pull a model
ollama pull llama3.1:8b
# 3. Clone & install
git clone https://github.com/ThatDeparted2061/ArchitectOS.git
cd ArchitectOS
npm install
# 4. Run
npm run devFirst generation takes 15-30s (model loading into RAM). Subsequent ones are faster.
Edit backend/.env:
AI_ENABLED=true
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama3.1:8bSwap OLLAMA_MODEL for any model: mistral, codellama, llama3.1:70b, etc.
| Mode | Description |
|---|---|
| AI Decompose | Prompt → AI generates full architecture |
| Hybrid | AI generates → you edit, add, or delete nodes |
| Manual Mode | Build from scratch (coming soon) |
- Click 📤 Upload Codebase
- Select source files or a ZIP archive
- AI analyzes the code structure and generates an architecture flowchart
- Edit in Hybrid mode, download as ZIP, or generate a README
Supports: .js, .ts, .py, .java, .go, .rs, .c, .vue, .svelte, and 30+ other file types.
| Layer | Technology |
|---|---|
| Frontend | Vue 3, Vite, Vue Flow, Pinia, Tailwind CSS |
| Backend | Express, TypeScript |
| AI | Ollama (local LLM) |
architect-os/
├── backend/
│ ├── index.ts # Express API server
│ ├── mock/ # Fallback mock data
│ └── .env # Configuration
├── frontend/
│ ├── src/
│ │ ├── components/ # Vue components
│ │ ├── services/ # API + graph layout
│ │ ├── store/ # Pinia state management
│ │ └── App.vue # Main app
│ └── ...
└── package.json # Workspace root
MIT