⚠️ Kompo is no longer maintained

Kompo has been discontinued and is no longer actively maintained.

The repository is kept available for archival and reference purposes, but no new features, bug fixes, or support should be expected.

Thank you to everyone who contributed, tested, reported issues, or used Kompo.

Status: Archived
Maintenance: Discontinued
Date: October 2026

---

Kompo Agents

Privacy-first, IDE-agnostic AI agents for Kompo.

Local inference via Ollama • RAG via Upstash Vector • Works in any IDE

---

What is Kompo AI?

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)

How it works

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)

Quick Start

# 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-ai

Development

git clone https://github.com/kompojs/agents.git
cd agents
pnpm install
pnpm build

Monorepo Structure

agents/
├── packages/ai/     → @kompojs/ai (npm package)
├── models/          → Ollama Modelfiles (light/default/heavy)
├── scripts/         → Documentation indexing scripts
└── .github/         → CI/CD workflows

Related Repositories

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

License

MIT © 2026 SmarttDev and Kompo contributors