Quickstart

This guide takes you from a fresh server to a running Niyatna in a few minutes.

Before you start

Accounts you need

Niyatna runs on your own server, but it works through a few accounts that stay yours. Set these up first.

One AI provider. Your agents need a model to think with. Pick one:

OpenRouter — the free tier is enough to get started.
Or a subscription or API key you already pay for — Codex, Claude, Gemini, xAI (Grok), or a similar provider.

One messaging channel. This is how you talk to your agents day to day. Pick one:

Telegram, WhatsApp, Discord, Slack, LINE, WeChat, or another supported channel.

A Multica account at multica.ai. Multica is your company workspace: where you chat with your agents and plug in the AI tools you already use, such as Claude Code, Codex, Antigravity, or Grok Build.

Apps you connect with

Multica desktop — download it if you want to connect your workspace to your own machine.
Hermes — use Hermes on the web, or install the Hermes desktop app.

Keep the sign-in details for each one handy. You connect them while setting up your company.

Server requirements

Ubuntu 22.04 or 24.04 (64-bit).
At least 2 CPU cores and 4 GB of memory.
A working internet connection.
An account with permission to install software (a sudo user or root).

You do not need to be a server expert. The installer handles the setup for you.

Install

Run this one command on your server:

curl -fsSL https://get.niyatna.com/<YOUR_TOKEN> | sh

Replace <YOUR_TOKEN> with the token you were given. The command downloads the installer and runs it.

What the installer does

The installer works through the setup on its own:

Checks that your server meets the requirements.
Installs the software Niyatna depends on.
Creates your company's starting files, so your agents know who they work for and what they may do.
Adds the built-in abilities your agents use to handle everyday work.
Starts Niyatna and prints the address you use to open it.

There are no questions to answer while it runs.

Once it finishes, one command sets up your company: /niyatna-bootstrap.

Open Niyatna

When the installer finishes, it prints two things: a link, and your sign-in details.

Open the link in your browser and sign in with the username and password the installer created for you. That address is your company's home in Niyatna. From there you can give your agents work, watch what they are doing, and review what they have finished.

Prefer the desktop app? Download Hermes desktop and paste that same link as your remote URL. It opens straight into your company.

Keep the link and your sign-in details somewhere safe. You can change the password any time from the Hermes dashboard.

Finish setup: run /niyatna-bootstrap

Niyatna is running, but your company is not set up yet. One command does that:

/niyatna-bootstrap

Run it from whichever entry point you like:

In your terminal — start hermes --tui and run it there.
In your messaging channel — the one you chose during setup.
In the web app — the link the installer printed.

It sets everything up: your company, your agents, and the tools they use. You only need to run it once.