Practical overview
When it fits
Use Kerux when you need a self-hosted agent runtime that combines terminal interaction, tool execution and optional coding or messaging workflows rather than a text-only model interface.
Who it is for
- Developers building self-hosted LLM agents with tool execution.
- Teams exploring autonomous coding workflows with repository context and validation.
- Builders composing external tools through MCP.
- Operators connecting agent interactions to supported messaging channels or webhooks.
Documented uses
- Run interactive or one-shot LLM agent sessions.
- Execute tools incrementally as streamed model output arrives.
- Work through coding tasks from a TODO.md file and apply configured validation.
- Connect agent conversations to Telegram, WhatsApp, Discord and Slack.
- Persist sessions, memory, todos and cron jobs across restarts.
Requirements & limits
Kerux is public, open source and licensed under MIT. The repository documents installation through Cargo or prebuilt GitHub Releases binaries. Provider credentials or the documented Nous OAuth login path are needed for model access.
- The runtime is implemented in Rust and supports CLI, desktop-terminal and self-hosted usage.
- Its streaming-first loop processes tool calls incrementally from partial model output.
- Autonomous coding mode depends on a TODO.md workflow and configured local validators.
- Gateway use involves external messaging channels, webhooks and their associated setup.
- MCP support is included for composing external tools.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Configure Kerux and start a chat
Set up a provider, key, and model through the interactive wizard, then open the terminal chat interface.
Before you start
- Kerux is available as the
keruxcommand. - A provider and its credentials, unless using the documented Nous OAuth login option.
Steps
Run
kerux wizardto configure the provider, key, and model.Alternatively, set
OPENAI_API_KEYor usekerux auth login nousfor OAuth.Run
kerux chatto open the prompt-first terminal interface.
Expected outcome
Kerux opens its chat interface with provider configuration in place.
Guide limitations
- The source does not specify installation steps or provider-specific configuration details.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 4 October 2026
- Original website title
- eikarna/kerux · Official homepage title · retained in its source language

