Skip to main content
A stone cottage with a server cabinet blinking green in its doorway, a watering can and a flower path. Ouro waits by the step holding a silver cloche, ready to serve.

Ouro Butler

An Ouroboros agent that looks after a home server. It notices when something your household counts on stops working, fixes what it is allowed to, and tells you the rest on Telegram.

Install it

AlphaInstalls on Unraid 7.2 or newer with one script.

What it does

  • Notices when something stops working

    It watches the services, storage and endpoints the household relies on, and tells a stopped service you meant to stop from one that broke.

  • Looks before it speaks

    It checks live state and logs before it answers, so each reply says what is actually wrong.

  • Fixes what it is allowed to

    A restart happens only when you have said a service should be on, granted that action, and a fresh request or health event calls for it. Each one is rate-limited and verified afterwards.

  • Keeps quiet otherwise

    It holds on to unfinished work, skips repeat alerts that say nothing new, and messages you when there is something to decide or something done.

What it sounds like

Short, phone-sized replies, with the most useful thing first.

  1. YouWhat's up?
  2. ButlerTwo things need a look: the library service is down, and storage is at 76%. Telegram and my own health check are fine. I would start with the library.
  3. YouIs the TV working?
  4. ButlerPlayback is up. New downloads are stuck because the provider's sign-in failed. I haven't changed anything. Want me to keep watching it?
Dramatization Written from the replies the Butler is designed to give. Not a real conversation.

How it stays safe

  • Its personality and instructions are mounted read-only, so the agent cannot rewrite who it is.
  • Grants live in a root-owned folder outside the agent, and it honors a grant only when the whole path to it is closed to other writers.
  • It records every attempt, including the ones that failed or ended unclear, and never replays an attempt whose effect is uncertain.
  • Anything without a grant waits for you to approve it.

Install it

The Butler is an alpha: it runs our own server every day, and the installer is new. Expect rough edges, and keep your own backups.

What you need

  • Unraid 7.2 or newer, with Docker enabled.
  • An Anthropic API key with credit on the account. The Butler thinks with Claude models.
  • A Telegram bot of its own: message @BotFather, send /newbot, and keep the token.
  • An email address for the Butler's vault account, one no other Butler uses.

Run the installer

Open the Unraid web terminal, download the installer, read it if you like, and run it. It asks a few questions, reads secrets with the echo off, and says what it is doing at each step. When it finishes, say hello to your bot on Telegram.

curl -fsSLo /tmp/ouro-butler-install.sh https://github.com/ourostack/ouroboros/releases/latest/download/install.sh
bash /tmp/ouro-butler-install.sh

The full install guide ↗ The Butler's deployment files ↗ The Ouroboros harness →