The Brain and the OS, on One Computer

Where this comes from

The Brain That Runs a Company was built one organ a week, in twelve live classes: senses, memory, voice, hands, a clock, a graph, a cockpit, a mouth, a phone, a socket. Each class shipped its own pack, and each pack assumed you had done the one before it. That is fine if you were in the room every Wednesday. It is a lot to ask if you arrive at class 9.

This pack is the shortcut. It installs the whole brain and the AI Automation Base OS dashboard on one computer, connects them, and gives them a single memory. You still get the classes: each one is built on your machine by Claude Code from that class's own pack, and it only counts as installed when the pack's own verify script passes. You can still open any class and read how its part works.

Created by Hector Diaz, founder of Orbix Automation Solutions.

What you build

The parts, in the order the installer puts them on your machine, are in the table above. In plain terms:

• The brain. n8n and Postgres in Docker, with the class workflows:
  • email sorted into a table;
  • memory you can ask questions;
  • a morning digest;
  • reply drafts that are never sent;
  • your calendar;
  • file ingress with four zones;
  • a module host.
• Channels. One small gateway for Telegram, Slack and WhatsApp. It needs no public URL or domain, because every connection goes out from your machine. The brain answers you there, and it also messages you first, for example the digest or a new file.
• AI Automation Base OS at localhost:3737. Its Brain page has:
  • links to Files (where you feed the brain documents), n8n and the brain dashboard;
  • your channels;
  • where each notification goes;
  • a search box.
• One memory. Your Obsidian vault is indexed into the brain, so the brain can find your notes by meaning. What the brain learns comes back into the vault as notes in a Brain/ folder: documents you fed it, mail by day, an index. The same search works from the OS Memory page and from Apollo.
• Google Cloud CLI. Signed in, with its own new project and the Calendar, Gmail and Drive APIs turned on. They are free.

Do you need this? Be honest first

Use it if:

• You want the brain from the classes running on your own computer, and you would rather not assemble twelve packs by hand.
• You already use AIAB OS and want it to finally know what your business knows.

Skip it if:

• You want to learn each organ by building it yourself. Take the classes in order instead; that is what they are for.
• You only need one piece. The single-class packs are lighter.
• You are not comfortable with Docker running on your machine, or with an AI agent building things in a folder of yours. The classes are built by Claude Code with permission to run commands, inside ~/brain.

What it deliberately does not do

• It never sends an email. The drafts stay drafts.
• It never buys anything. The phone class uses a Twilio number you already have, and only if you ask for that class.
• It never puts a key in a file it ships or a workflow it exports. Your keys live in ~/.aiab/secrets.env, which only you can read.
• It never sends a vault note that looks like it holds a secret. That covers API keys, passwords and private keys; the Brain page lists the notes it kept out.
• It does not expose anything to the internet. Everything listens on localhost. The one exception is the phone class, which opens a single /twilio/ path, only with your own tunnel.
• No account link. It does not phone home and does not update itself. A new version is a new download.

What you need

• A computer:
  • macOS on Apple Silicon or Intel;
  • Debian, Ubuntu or Raspberry Pi OS;
  • Windows 10 or 11, where the installer sets up WSL and Debian for you, with one restart the first time.
  • 8 GB of RAM is comfortable. On a smaller machine it adds swap. About 10 GB of disk.
• A Claude Code plan. The classes are built by Claude Code, and you sign in once.
• An OpenRouter key with about $5 of credit. This is the only key that is required.
• Optional, each one adds a class or a channel:
  • a mailbox app password;
  • your calendar's private iCal link (Google, Outlook, iCloud, Nextcloud, Radicale or any iCal);
  • a Telegram bot, a Slack app, or a second WhatsApp number;
  • your Obsidian vault;
  • a Twilio number.
  • Leave one empty and that part is skipped. You can add it later with aiab-install keys.

What is in the zip

Not in the zip: the editable Blender sources of the AIAB OS 3D Worlds. The worlds run without them; the sources are the optional download in the AI Automation Base OS pack.

The installer checks what is already on your machine and skips it, so running it again is safe. aiab-install status shows each part and why anything was skipped. aiab-install uninstall removes what it added and keeps your data. --purge also removes your data.

What was verified and what was not

Verified:

• On a Windows 11 machine running WSL Debian, a full run through the same bundle:
  • Classes 2, 3, 5, 6, 8, 9, 10, 11 and 12 each passed their own pack's verify script.
  • Mail sorting and drafts ran on nine real mailboxes.
  • The phone class answered on a real Twilio number behind a /twilio/-only tunnel.
  • The shared memory indexed a vault of about 1,200 notes and kept 30 secret-looking notes out.
• The Windows one-liner ran on that same machine. WSL and Debian were already installed there, so the parts that install them were never exercised.
• This offline zip installed from its own folder, with no account and no download.
• On a Mac with Apple Silicon, the installer ran and the brain and the OS came up running.
• A full uninstall on a Windows machine with WSL. Asked to remove AIAB OS and all its modules, Claude Code asked several confirmation questions, then removed everything except itself. It said before starting that it would not remove Claude Code because it was running inside it, and at the end it gave the commands to uninstall Claude Code separately. As the last step it said to run wsl --shutdown from a Command Prompt (cmd) window, not from PowerShell.

Not verified yet:

• A Mac with an Intel chip.
• A Raspberry Pi.
• A Windows machine with no WSL, which takes the restart path.
• Uninstall on macOS or Linux.

If something breaks on yours, post the last lines of ~/.aiab/install.log in the community. That is how the next version gets better.

Read the prompt before you run it

The classes taught one habit: hand every script and prompt to Claude first and ask what it will do. Keep it here.

• Open install.sh and read it.
• Or open Claude Code in the unzipped folder and ask: "Read install.sh and INSTALL-WITH-AI.md. Tell me exactly what they install, where they write, and what they will ask me for."
• Then decide.