What is Zaruka?
A decentralized personal AI assistant that runs entirely on your machine. No data leaves your server.
Model-agnostic: use Claude, GPT, Ollama, or any LLM provider you prefer.
Chat with it through Telegram. Manage tasks, track email subscriptions, and more.
Features
Everything you need in a personal assistant, nothing you don't.
Self-hosted & private
All data stays on your machine. No cloud, no tracking, no compromise.
Natural language interface
Chat with your assistant via Telegram, just like messaging a friend.
Task management
Create, track, and complete tasks with smart reminders.
Email tracking
Monitor subscriptions and important emails automatically.
Extensible skills
Modular architecture — add new skills as you need them.
How it works
Install
Run the install command or deploy with Coolify / Docker.
Add your Telegram bot
Paste the bot token from @BotFather — that's the only thing you need to get started.
Chat
Open your Telegram bot — it will walk you through the rest: choosing an AI provider, setting up skills, and everything else.
Deployment options
CLI
One command to install. The setup wizard will ask for your Telegram bot token and you're good to go.
curl -fsSL https://zaruka.pro/install.sh | bash
Docker Compose
Clone the repository, set your Telegram bot token in the .env file, and start. The bot will message you in Telegram to finish the setup.
git clone https://github.com/zaruka-ai/zaruka
cp .env.example .env
# Edit .env — add your ZARUKA_TELEGRAM_TOKEN
docker compose up -d
Coolify
If you're using Coolify as your hosting panel, deploying Zaruka takes just a few clicks:
- Open your Coolify dashboard and click Add Resource
- Select Docker Compose as the resource type
- Choose Public Repository and paste the repo URL:
https://github.com/zaruka-ai/zaruka
- Go to Environment Variables and add:
TELEGRAM_BOT_TOKEN— your bot token from @BotFather - Click Deploy — Coolify will build and start the container automatically