Install the agent

One command, four screens.

Read as Markdown

Run this on your agent's machine—the computer or server where Optakt One will run:

curl -fsSL https://get.optakt.ai | bash

On the first run, paste your licence key. It is checked before anything is downloaded. The script then downloads the optakt command for your agent's machine, verifies it against the release checksum, and starts the installer. On Linux it asks for your sudo password once; on a Mac, only to place the optakt command in /usr/local/bin.

The four screens

Nothing happens on your agent's machine that a screen has not shown first.

  1. Configure Provider. Choose your model provider and how you sign in: an API key, a subscription, or the address of a local model server. The connection is tested at once. Then choose the model your agent thinks with. You can change it later.
  2. Setup Database. On a machine without PostgreSQL, choose Managed by Optakt, and PostgreSQL 18 is installed and set up for you. If you already run PostgreSQL, it stays yours: the installer uses it without taking it over, or you give it the address of a server you manage elsewhere.
  3. Deploy Service. Name your agent, and create your owner account: name, email and password. Then paste your Telegram bot token. A shared Voyage AI key is filled in during launch; we strongly recommend your own key. ElevenLabs is recommended if you want to use voice notes. Both are optional services.
  4. Execute Installation. The installer sets everything up and shows each command as it runs: the service account and folders, the database, the tools that read documents and voice notes, and the service itself. It then checks that the service answers.

The last screen links to your bot on Telegram. Enter opens the admin app. Next: your first conversation.

If the install stops

Using a database you manage

An existing or remote server must run PostgreSQL 18 with vector, pg_search, pg_trgm and uuid-ossp. pg_search must be in shared_preload_libraries. The application user needs pg_read_all_settings to check those settings. The installer names any missing requirement and stops; it does not take over a database server you manage.

Continuing the install

The installer names the check that failed and why. Fix what it names, then run it again:

sudo optakt install

On a Mac, optakt install, without sudo. It continues from what is already in place.

Every command is logged, in /var/log/optakt-install.log on Linux and in ~/Library/Logs/io.optakt.one/install.log on a Mac.

On a Mac

Optakt One installs for the person who runs it, the way a Mac app does: everything lives under ~/Library/Application Support/io.optakt.one, and it runs in your own session. PostgreSQL comes from Postgres.app (opens in a new window), in its own copy beside the rest.

On an Intel Mac, one database extension is built from source. The installer says so first, asks for your administrator password if Xcode's command line tools are missing, and the build can take up to two hours.

Already installed

Running the command again on a machine with a working installation offers an upgrade instead.