Requirements
What you need before you install.
Read as MarkdownYour agent's 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 (opens in a new window). 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
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 for how the agent uses them.
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.
A licence key
The installer asks for it on the first run. See Get a licence.
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 for accounts, API keys, connection steps, costs and the local alternatives.