Your AI Teammates, running on your own infrastructure
Koris Bot is a TypeScript framework for building AI assistants with pluggable channels, extensible skills, and memory that persists across sessions — not just within a chat window.
Featured Capabilities
Signature building blocks engineered for local sovereignty and deep agentic control.
Pluggable Channels
Connect Telegram, WhatsApp, Terminal UI, and Web Dashboard simultaneously without duplicating state.
Persistent SQLite Memory
Conversations, session trees, and long-term episodic recall stay on your local disk — never in a black box.
Markdown Skills
Teach the agent multi-step procedures and CLI commands using human-readable Markdown files — zero code.
Trust & Sandboxing
Granular per-channel permissions, domain allowlists, and strict tool execution boundaries keep your system secure.
Extend it in minutes
Teach the agent something new with a Markdown skill it reads, or a TypeScript tool it calls. Neither one touches core code.
---
name: weather
description: Get current weather and forecasts via wttr.in, no API key needed.
read_when:
- user asks about weather, temperature, or forecasts for any location
---
# Weather
Current weather conditions and short-range forecasts.
## Commands
### Current Weather
```bash
curl "wttr.in/[city]?format=3"
```
Response: `[city]: ⛅ +17°C`No changes to core needed — drop the file in and it's picked up automatically. Full guide: Skills docs.
Made for people who love building
A few ways developers, self-hosters, and teams turn Koris into their autonomous daily driver.
“Running Koris on my home server with Ollama. Having a personal assistant on WhatsApp that remembers my notes without sending data to third parties is unbeatable.”
Alex Oliveira
Homelab & Self-Host Enthusiast
“The Markdown skill system is brilliant. Drop a single file with instructions and curl commands, and the bot immediately executes staging tasks reliably.”
João Pedro
DevOps Lead
“Unlike bloated AI frameworks, Koris is clean TypeScript with local SQLite. Fast to boot, zero lock-in, and dead simple to customize.”
Higor Santos
Fullstack Developer
“Unified Telegram and Web UI messaging backed by the same persistent memory tree. Exactly what our team needed for internal automations.”
Robson Rocha
Systems Architect
Get Koris Bot running
Install the desktop app, or build it from source. Either way, the first launch drops you into a browser setup wizard — no manual config editing.
A self-contained build — agent, dashboard, and channels in one installer.
Links point straight at the latest GitHub release assets — the version is resolved automatically.
Frequently Asked Questions
Everything about open source, local architecture, and running your own assistant.
Changelog
Every release, straight from GitHub.