Sourav AI Labs project
Mini Krill
A local-first AI agent with a crustaceous soul. Built by Sourav Singh / Sourav AI Labs. Inspired by Jarvis and OpenClaw.
Mini Krill is designed for people who want a practical personal agent without starting with API keys or cloud accounts. The first-class path is local Ollama — everything stays on your machine. Subscription-backed Codex and Claude Code support delegates authentication to the official CLIs, so Mini Krill does not store provider OAuth tokens.
It runs on Windows, Linux, and macOS as a single binary. Local inference uses Ollama.
Install
curl -fsSL https://raw.githubusercontent.com/srvsngh99/mini-krill/main/scripts/install.sh | bash
minikrill init
minikrill chat
Provider Options
| Provider | Best for | Auth model |
|---|---|---|
| Ollama | Private local chat and task planning | No account required; recommended gemma3:4b |
| Codex | Coding and repo-aware work | codex login via ChatGPT subscription |
| Claude Code | Coding, analysis, and terminal workflows | claude auth login via Claude subscription |
Inside chat:
/models
/use local
/use codex
/use claude
Key Features
- Plan-before-execute — the agent shows its plan and waits for your approval before acting
- Unified memory — move between CLI, TUI, Telegram, and Discord with shared continuity
- Personality system — not a boring assistant, a crustaceous AI buddy with soul
- Plugin system — YAML-based skill registry for extensible capabilities
- Health monitoring — heartbeat, doctor diagnostics, and sonar pings
- TUI dashboard — ocean-themed terminal UI with real-time status
Security & Privacy
- Local-first: with Ollama, all data stays on your machine
- No telemetry: Mini Krill never phones home or collects analytics
- Credential delegation: OAuth tokens stay in the official provider CLIs
- Untrusted content sandboxing: external content is marked as data-only, preventing prompt injection
- SSRF protection: HTTP client blocks requests to private/loopback addresses
All data is stored locally in ~/.mini-krill/.
Documentation
| Guide | Covers |
|---|---|
| Install and setup | Provider choice, integrations, Windows/macOS/Linux setup |
| Provider switching | Ollama, Codex CLI, Claude Code, and chat switching commands |
| Memory and preferences | Local storage and how preferences follow provider switches |
| Interfaces | Telegram bot, CLI, and Discord bot setup |
| Automation workflows | Reminders, file summaries, web summaries, and research |
| Testing checklist | Commands to verify install, providers, memory, and builds |
| Troubleshooting | PATH, Ollama, Codex login, Claude login, and memory checks |
The full docs live in the Mini Krill GitHub repo under docs/.
Current Status
Mini Krill v0.1.0 is open source under the MIT license. It is actively maintained and being hardened for production workflows.