Privacy-first, IDE-agnostic AI agents for Kompo.
Local inference via Ollama • RAG via Upstash Vector • Works in any IDE
Kompo AI is a domain-specialized LLM agent for TypeScript code generation with the Kompo framework. It understands hexagonal architecture, ports & adapters, and Web3 patterns.
Key features:
- IDE-agnostic — Works in Cursor, Windsurf, VSCode, Gravity, or any IDE that supports custom LLM endpoints
- Privacy-first — All inference runs locally via Ollama. Your prompts and code never leave your machine.
- RAG-enhanced — Retrieves relevant Kompo documentation and project context for every query
- Skills system — Extend with domain-specific knowledge packages (
@kompojs/skill-*) - Local management — Manage your plan, quota, and skills via the Kompo Workbench (no SaaS dashboard)
Your IDE (Cursor, Windsurf, VSCode...)
│
▼
Kompo AI Proxy (localhost:11435) ← OpenAI-compatible API
│ 1. Check quota (daily + monthly)
│ 2. Enrich with RAG context
│ 3. Forward to Ollama
│ 4. Count tokens
▼
Ollama (localhost:11434) ← Local LLM inference
└── kompo-ai model (qwen2.5-coder)
# Install the Kompo CLI (if not already)
pnpm add -g @kompojs/cli
# Setup Kompo AI (installs model, configures proxy)
kompo ai:setup
# Start the proxy (runs as daemon)
kompo ai:serve
# Use from terminal
kompo ai
# Or add to your IDE:
# Endpoint: http://localhost:11435
# Model: kompo-aigit clone https://github.com/kompojs/agents.git
cd agents
pnpm install
pnpm buildagents/
├── packages/ai/ → @kompojs/ai (npm package)
├── models/ → Ollama Modelfiles (light/default/heavy)
├── scripts/ → Documentation indexing scripts
└── .github/ → CI/CD workflows
| Repository | Description |
|---|---|
| kompojs/kompo | CLI, kit, config, core runtime |
| kompojs/workbench | Visual DevTools + AI management UI |
| kompojs/blueprints | Blueprint packages |
| kompojs/docs | Documentation |
| kompojs/platform | Backend APIs |
MIT © 2026 SmarttDev and Kompo contributors