# Requirements (https://optakt.ai/docs/requirements)

## Your agent's machine [#your-agents-machine]

This is the computer or server running Optakt One. **Your device** is where you use Telegram. They can be the same computer, or separate devices.

Optakt One runs on Linux or Mac:

- **Linux** with systemd. Standard automatic setup covers the Debian/Ubuntu and Fedora/RHEL families; other distributions may need manual dependency setup. The install needs root.
- **macOS** 10.15 or later, with [Homebrew](https://brew.sh). It installs for the person who runs it, without root.

There is no Windows version.

Your agent works while its machine is on. A server, rented or your own, keeps it available around the clock; the computer on your desk works too, as long as it is running.

On a Mac with an Intel processor, one database extension is built from source during the install. That step can take up to two hours. On Apple silicon it is a download.

## A model provider [#a-model-provider]

One of these, and the installer tests it before going on:

- **An API key** from Anthropic, OpenAI, Google, xAI, DeepSeek, Moonshot, Qwen, MiniMax, Z.AI, Xiaomi MiMo or OpenRouter.
- **A subscription** you already pay for: Claude, ChatGPT or Grok, connected by signing in.
- **A model server you control**, such as Ollama, running on your agent's machine or another computer you control.

See [Models](/docs/models) for how the agent uses them.

## A Telegram bot [#a-telegram-bot]

You talk to your agent on Telegram, through a bot of your own. Creating one takes two minutes: see [Create a Telegram bot](/docs/telegram-bot).

## A licence key [#a-licence-key]

The installer asks for it on the first run. See [Get a licence](/docs/licence).

## Optional [#optional]

- **Voyage AI — highly recommended for meaning-based search.** We provide a shared key during launch, but it may become unavailable if the costs become unsustainable. We strongly recommend connecting your own key for continued access.
- **ElevenLabs — recommended if you want to use voice notes.** It transcribes voice and video notes. Without it, transcription runs on your agent's machine.

See [Voyage AI and ElevenLabs](/docs/optional-services) for accounts, API keys, connection steps, costs and the local alternatives.