Yuna docs
Yuna is an npm CLI (yuna-bot) and a bundled Next.js server that, together, let you deploy an AI-powered Telegram orchestrator for your personal device fleet. The wizard walks you through Telegram, Anthropic, Upstash, and Vercel setup, deploys a serverless function to your Vercel account, and hands you a bot you can message from anywhere.
Start here
- Install — end-to-end setup in about 5 minutes.
- Architecture — how the webhook, orchestrator, Redis Streams, and device agent fit together.
- Commands — every CLI subcommand and every Telegram slash-command.
What you'll need
| Service | Why | Cost |
|---|---|---|
| Telegram bot | Your chat interface | Free |
| Anthropic API key | Claude Haiku by default | ~$0.001/msg |
| Upstash Redis | Queues, conversation, audit log | Free tier: 10k cmds/day |
| Vercel | Server hosting | Free tier: 100k invocations/mo |
Typical cost for personal use: under $5/month with Haiku, even heavy daily use.
Yuna is self-hosted. There is no SaaS — you run your own Vercel instance, bring your own API keys, and nothing is shared with anyone. Your conversation history lives in infrastructure you control.