Get up and running with AI agents.
15 MB single binary. Markdown configured.
Ollama local, Claude cloud, or any OpenAI-compatible endpoint.
Quick Start
Up and running in 60 seconds
Install
# macOS / Linux / Raspberry Pi curl -fsSL https://localkin.dev/install.sh | sh # Or build from source git clone https://github.com/LocalKinAI/localkin.git && cd localkin go build -o localkin ./cmd/localkin/
Pick a soul
# 7 example souls included: souls/ ├── coder.soul.md # Claude Sonnet 4.6 ├── researcher.soul.md # Web search + analysis ├── ollama.soul.md # Ollama local (llama3.1) ├── openai.soul.md # OpenAI GPT-4o ├── deepseek.soul.md # DeepSeek Chat ├── groq.soul.md # Groq Cloud (free Llama) └── locked.soul.md # Read-only sandbox
Run
# Local — fully offline, private localkin -soul souls/ollama.soul.md # Claude — free via OAuth login localkin -login localkin -soul souls/coder.soul.md # Voice mode (Pioneer) localkin -soul souls/coder.soul.md -voice
Features
What lives inside 15 MB
The Soul System
One .soul.md defines your agent — identity, model, permissions, skills. YAML frontmatter + Markdown body. Hot-swap with /soul at runtime.
The Self-Forging Agent
"Create a skill that monitors Bitcoin." It writes the SKILL.md, generates the script, and activates it. Circuit breaker prevents runaway loops.
Web Search & Unix Pipeline
DuckDuckGo web search built in — zero config, no API key. Pipe mode for scripting: localkin -exec "summarize" < server.log > summary.txt.
The Persistent Memory
SQLite-backed memory that survives reboots. Conversations persist across sessions. Command history with Up/Down arrow navigation.
The Offline JARVIS
localkin -voice — continuous hands-free mode. Streaming VAD with zero-gap capture, auto language detection. Three-tier TTS: local Piper → edge Kokoro → cloud.
The Terminal App Store
/skill search bitcoin → /skill install btc_monitor — or just ask the AI. Browse, install, and manage skills without leaving the terminal.
See it in action
Your AI agents, anywhere
18+ agents on a Mac Mini. Pick one from your phone, start chatting. View all demos →
Agent App Store
Browse and switch AI agents from your phone. Each agent runs as its own process — multi-user, zero conflict. GitHub Scout fetches trending repos, English Tutor drills pronunciation, Madame Guyon offers counsel.