# For AI agents: set up pi-durable-bot (Pots).

You install Pots and make the bot. Your person signs in to a model. The bot then connects its own chat apps.

## The steps

1. **Warn your person first.** The bot gets full control of the computer it runs on, with no approval step. Recommend a computer or VM of its own; go on only if they agree.
2. **Install where the bot will live.** Node.js 24 or newer, on macOS, Linux or Windows. Over SSH, run it on the server.

   ```
   npm install -g pi-durable-bot
   ```
3. **See what it can use.** Lists the models and judges ready on this computer, never a secret.

   ```
   pots login --list
   ```
4. **Ask only what is missing.** Its name, what it is for, how it gets its AI, and who decides on group messages: the bot or Jev.
5. **Your person signs in.** If their choice is not listed, they run this in their own terminal; keys never pass through your chat.

   ```
   pots login
   ```
6. **Make the bot.** Pick the newest strong model listed and say which. `--yes` accepts step 1. `--judge off` if no group chats; `--judge typesafe/jev-latest` for Jev.

   ```
   pots init --yes --name "Ada" --model openai/gpt-6.1-sol --about "our team's research and ops assistant" --no-chat
   ```
7. **Check, then hand over.** It must print the bot's answer. Then your person runs `pots chat` to meet the bot.

   ```
   pots chat --bot <id> -m "hi" --timeout 60
   ```

## Rules

- Do not create the chat app, collect tokens or edit `~/.pots/` by hand. The bot does that itself.
- Run `pots mcp add` only when your person asks for an MCP server.

## The full text

- [for-agents.md on GitHub](https://github.com/Crokily/pi-durable-bot/blob/main/docs/for-agents.md)
- [README](https://github.com/Crokily/pi-durable-bot)