# Xiryn (Xiryn agent)

> Xiryn is the free, open-source personal AI agent that does everything Muse, Grok Bot and Dots do — on your own computer. Each agent gets its own Linux desktop in Docker, so it works in the background and never touches your screen, mouse or files. Private by design (no account, no telemetry, data in one file on your disk), works with any model, and can be controlled from anywhere through Telegram. MIT licensed.

## Key facts

- Website: https://xiryn.com
- Source code: https://github.com/SouravBeraAkaSpeed/xiryn (MIT license)
- Author: Sourav Bera
- Runs on: macOS, Windows and Linux (Node.js 20.9+ and Docker; the setup installs them)
- Models: OpenAI, Anthropic, Google Gemini, xAI, Groq, Mistral, DeepSeek, OpenRouter, Ollama, LM Studio, or any OpenAI-compatible API
- Price: free; you pay your model provider directly, or run a local model

## What it does

- Each agent works on its own sandboxed Linux desktop (a Docker container with a real Chromium, a shell and files) on your computer.
- Browses and researches the web, writes and runs code, fills forms, prepares orders and bookings.
- Payments: cards and logins are encrypted (AES-256-GCM, key held by the OS); every payment needs the user's approval, in the app or with one tap on Telegram.
- Hand-offs: at a login, payment, one-time code or CAPTCHA the agent stops and hands over its live desktop, which can be used from a phone.
- Squads of agents delegate work to each other; long-term memory is stored locally and editable.

## Install

- macOS / Linux: `curl -fsSL https://raw.githubusercontent.com/SouravBeraAkaSpeed/xiryn/main/setup.sh | bash`
- Windows (PowerShell): `irm https://raw.githubusercontent.com/SouravBeraAkaSpeed/xiryn/main/setup.ps1 | iex`
- Or paste the setup prompt from the README into a coding agent (Claude Code, Codex, Cursor).

## Docs

- [README and quick start](https://github.com/SouravBeraAkaSpeed/xiryn#readme)
- [Changelog](https://github.com/SouravBeraAkaSpeed/xiryn/blob/main/CHANGELOG.md)
- [Telegram remote control](https://github.com/SouravBeraAkaSpeed/xiryn/blob/main/docs/telegram.md)