8gent is an autonomous coding agent. Free and local-first by default. Install globally with npm install -g @8gi-foundation/8gent-code, then type 8gent anywhere. The active provider out of the box is 8gent local (eight-1.0-q3:14b), with ollama also enabled. The adaptive router wires 11 providers (8gent, ollama, openrouter, groq, grok, openai, anthropic, mistral, together, fireworks, replicate); everything past ollama is opt-in via API key. It uses the BMAD methodology for structured planning and execution, AST-first navigation for token efficiency, and self-improves via autoresearch and kernel fine-tuning.
Get Started
Installation
Get 8gent running on your machine in 5 minutes with Bun and the local provider.
Quick Start
Your first coding session: from prompt to shipped code.
Configuration
Customize models, providers, and agent behavior.
Architecture
System Overview
How the kernel, model router, and agent loop fit together.
Eight's Soul
Identity, voice, principles, and boundaries of the agent.
Model Router
Intelligent routing across local and cloud models.
Autoresearch
Self-improving benchmark loops and pattern extraction.
Kernel Fine-Tuning
LoRA training pipeline for local model specialization.
Guides
BMAD Method
Structured planning and execution methodology for complex tasks.
MCP Integration
Connect external tools and services via Model Context Protocol.
OpenRouter
Use cloud models as fallback when local inference isn't enough.
Personalization
Teach Eight your preferences, patterns, and project context.
Terminal UI
The interactive TUI for real-time agent collaboration.
Reference
Benchmarks
39+ task test suite across 6 tiers and 15 professional domains.
CLI Reference
All commands, flags, and environment variables.
Slash Commands
In-session commands for controlling agent behavior.
Tools
Built-in tool definitions and custom tool creation.
Hooks
Lifecycle hooks for extending agent behavior.
Design Systems
Token-based design system for consistent UI output.