Overview

Koris is an autonomous AI-agent framework you run on your own infrastructure. It receives messages through pluggable channels, runs them through an LLM, executes tools on your behalf, and keeps memory and sessions in a local SQLite database so state persists across restarts.

Start here

  • Getting Started — requirements, install, first run, configuration.
  • Concepts — how a message becomes a reply: sessions, memory, compaction, trust.

Building blocks

  • Channels — Telegram, WhatsApp, the terminal UI, and the web dashboard.
  • AI Providers — providers, roles, embeddings, queueing.
  • Tools — the actions the agent can take beyond replying.
  • Skills — Markdown files that teach the agent how to handle a kind of request.
  • Plugins — extend Koris without touching its core.
  • Commands — slash commands intercepted before a message reaches the agent.

Operating Koris

  • Admin Dashboard — the browser surface for chatting and configuration.
  • Security — running safely on public channels and untrusted input.

Elsewhere