<!--
title: Start Here
description: The AI Shuffle documentation, in the order you need it
order: 0
-->

# AI Shuffle documentation

AI Shuffle is a self-hosted workspace for AI agents, made by HobbyCoders. You run it on your own computer, server or NAS, and use it from a browser, the desktop app or your phone. Agents run on **your own** AI account: you connect a provider with a subscription sign-in or an 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](/docs/getting-started/requirements) | Before you buy or install: hardware, accounts and network. |
| [Choose an install](/docs/getting-started/installation) | You want to know which install fits your computer or server. |
| [Install with Docker](/docs/getting-started/install-docker-compose) | You run Linux, a NAS, a home server or any machine with Docker. |

## Set up

| Page | Read it when |
| --- | --- |
| [First run](/docs/getting-started/first-run) | You open AI Shuffle for the first time. |
| [Modes and costs](/docs/getting-started/modes-and-costs) | You are choosing between a subscription and an API key. |
| [Quick start](/docs/getting-started/quick-start) | Setup is done and you want to start working. |
| [Remote access](/docs/getting-started/remote-access) | You want to use AI Shuffle from your phone or away from home. |

## Keep it running

| Page | Read it when |
| --- | --- |
| [Updates](/docs/getting-started/updates) | A new version is out. |
| [AI Shuffle Cloud](/docs/getting-started/cloud) | Free local use, remote workers, paid plans, cancellation and refunds. |
| [Troubleshooting](/docs/getting-started/troubleshooting) | Something does not work. |
| [FAQ](/docs/getting-started/faq) | You have a question about accounts, privacy, pricing or support. |

## Everything else

- [Overview](/docs/getting-started/overview): what AI Shuffle can do.
- [Features](/docs/features/profiles): agents, projects, automations, hooks, MCP servers, plugins, voice and more.
- [Connectors](/docs/connectors): Telegram, Discord, Slack, WhatsApp, Home Assistant and more.
- [API reference](/docs/api-reference): the REST and WebSocket API for your own integrations.

## Get help

Email support@hobbycoders.com. Never send passwords, API keys, sign-in codes or plan keys. The same documentation is on [hobbycoders.com](https://hobbycoders.com/ai-shuffle), together with the [FAQ](https://hobbycoders.com/ai-shuffle/faq), [privacy policy](https://hobbycoders.com/privacy) and [license terms](https://hobbycoders.com/license).