Kellix

A self-hosted AI assistant that actually does things. You talk to it on Telegram. Track food, coach workouts, browse the web, build integrations. One for every person in your house.

Install

curl -fsSL https://raw.githubusercontent.com/robertbrunhage/kellix/main/install.sh | bash

How it works

One command. Three minutes. Done.

1

Install

Run one command. Kellix starts on your machine inside Docker.

2

Set up

Open the dashboard in your browser. Add your family, connect your Telegram bot.

3

Use it

Everyone messages Kellix on Telegram. Each person gets their own private agent with their own memory.

Kellix online
Remind me to call mom at 5
Done. I'll ping you at 5pm.
lunch.jpg
Black bean bowl. 520 kcal logged.
What did I eat today?
1,840 kcal so far. 124g protein. You're on track.
Message Kellix...

What it feels like

Talk to it like a person.

📷 lunch.jpg
Log this
Black bean bowl with rice, avocado, and roasted peppers. Logged: 520 kcal, 18g protein, 16g fat, 72g carbs.
I want a push/pull/legs routine for 4 days a week
Here's your split. Today is push day. Ready to start? I'll guide you through each set.
Can you build me an integration that pulls my Goodreads reading list?
Done. I created a new skill that fetches your shelf via their RSS feed. Want me to check it weekly and update your reading log?

Capabilities

Works like ChatGPT. Runs on your machine.

Tracks calories from a photo

Send a picture of your meal or scan a barcode. Kellix checks against a real food database and logs accurate macros.

Coaches your workouts

Designs routines, guides you through sets, and tracks your progress over time. Like a personal trainer in your pocket.

Connects to your devices

Withings scale, custom APIs, anything you want. Build new integrations through chat. Kellix writes the code, tests it, and starts using it.

Searches the web

Web search, browsing, screenshots. Works like ChatGPT or Gemini, but self-hosted and private.

One person or a whole family

Each person gets their own assistant with private memory and private conversations. Share household files when you want to.

Has its own browser

Each assistant gets a built-in browser to look things up, fill out forms, and take screenshots. Power users can connect their own browser for full remote control.

Under the hood

Built on OpenCode. Bring any model.

Providers

Any AI provider or your own

OpenAI, Google, or any OpenAI-compatible API. Run Ollama locally and your data never leaves your network. Switch per user or for the whole household.

Architecture

Isolated per-user containers

Each person runs in their own OpenCode container with its own workspace, memory, and tools. Nothing leaks between users.

Extensibility

Skills are just markdown

A skill is a folder with a SKILL.md and optional scripts. No SDK. Kellix reads the instructions and uses them. You can build new ones through chat.

Security

Encrypted vault for secrets

Credentials are stored encrypted and injected at runtime. The AI orchestrates workflows but never handles raw values.

Get started.

Docker is the only prerequisite. Run the install command, finish setup in your browser, and connect Telegram.

Install

curl -fsSL https://raw.githubusercontent.com/robertbrunhage/kellix/main/install.sh | bash