AI Shuffle documentation
AI Shuffle is a self-hosted workspace for AI agents, made by HobbyCoders. You run it on your own server, NAS or PC, and open it in a browser or the Android app. It runs AI agents with your own AI account: you connect any supported provider by subscription sign-in or API key, and that provider bills you directly. AI Shuffle never pays for, resells or sees your AI usage.
AI Shuffle is an independent product. It is not affiliated with, built, endorsed or supported by any AI provider.
Install
| Page | Read it when |
|---|---|
| Requirements | Before you buy or install: hardware, software and accounts. |
| Choose an install | You want to know which install fits your machine. |
| Install on Unraid | You run Unraid. |
| Install with Docker Compose | You run Linux, a NAS or any machine with Docker. |
Set up
| Page | Read it when |
|---|---|
| First run | The container is running and you open AI Shuffle for the first time. |
| Modes and costs | You are choosing between a subscription and an API key, or want to know what things cost. |
| Quick start | Setup is done and you want to start working. |
| Remote access | You want to use AI Shuffle from your phone or away from home. |
Keep it running
| Page | Read it when |
|---|---|
| Updates | A new version is out, or you want to know what the update check sends. |
| License | You activate a license, move it to another machine, cancel or ask for a refund. |
| Troubleshooting | Something does not work. |
| FAQ | You have a question about accounts, privacy, pricing or support. |
Everything else
- Overview: what AI Shuffle can do.
- Features: agents, projects, automations, hooks, MCP servers, plugins, voice and the worker network.
- Connectors: Telegram, Discord, Slack, WhatsApp, Home Assistant and more.
- API reference: the REST and WebSocket API for your own integrations.
Get help
Email support@hobbycoders.com. Never send passwords, API keys, pull tokens, license keys or sign-in codes. The same documentation is on hobbycoders.com, together with the FAQ, privacy policy and license terms.