Setup guides

Install the Bot

Put the Bot on the machine that will run it: a Raspberry Pi, a home server, or any always-on Linux box.

1. Build it from source — see the downloads page. There are no published binaries yet.
2. Run `aida-bot identity`. On first run the Bot generates its long-term key and prints the public half, along with the routing ID the Relay knows it by.
3. Run `aida-bot code` to print the claim code. It is the shared secret you will use to pair a browser with the Bot; `--rotate` replaces it.
4. Leave the Bot on the machine that will keep running it. Its key and your account credentials live there and nowhere else.

Claim your Bot

Tie the Bot to your account and establish the encrypted channel between it and your browser.

1. Create an account or sign in on this site.
2. On the Bot, run `aida-bot code` to read its claim code, and `aida-bot pair` to arm pairing. It accepts exactly one device and then stops; pairing is armed rather than always-on, because the claim code may be printed on a sticker.
3. Open your account and choose Claim a Bot, then type the code. Your browser derives a routing identifier from it and pairs with the Bot through the Relay. The code itself is never sent to Aida — only a value derived from it.
4. Pairing is also when the Bot collects its Aida LLM API credential, using a single-use token your browser carries. A failed pickup fails the whole pairing, so you never end up with a Bot that looks paired and cannot work.
5. Run `aida-bot devices` to see what is paired, and `aida-bot devices revoke <public-key>` to un-pair.

Connect a mail account

Give the Bot access to a mailbox. The credentials are stored on the Bot, never on Aida's servers.

Not built yet. Mail is Phase 3; this is here so you can see where the credentials will and will not go before you commit to anything.

1. Open Settings in the client app, with your Bot online.
2. Add an account: IMAP and SMTP hosts, or sign in with the provider where that is offered.
3. Choose which folders the Bot should watch.
4. Write a processing prompt saying what matters to you and what to ignore.