FILE // OTACON-EXPANSION TIER // PREMIUM · INSTALLABLE
Otacon Expansionfree · v1.3.1

Product // Multi-Agent & Emotional-State Layer · Release v1.3.1

Otacon Expansion

A five-agent roster with real hierarchy, a live mood and relationship engine, Culture Learning (Aria advances then teaches the crew), a standing REX business cycle, and command-center surfaces, installed on top of Otacon Core. Free forever, same as Core. Fresh PC truth: Aria + Deck/Codec install today; Genome Voice Trainer and Video Studio are optional and need GPU / Docker (or existing Comfy), not READY on every machine out of the box.

Download Expansion Setup → Support the build
All downloads GitHub v1.3.1 Install Otacon Core first →

Status

Installable today, with honest fresh-PC limits

What works on a normal fresh Windows PC after Core + Expansion Setup: five-agent roster with capability-parity acceptance suite + Hermes pipeline (v1.3.1). Soft-update pin faac7ea.

What is not automatic on every fresh PC: Genome Voice Trainer (needs a usable NVIDIA GPU path) and Video Studio / Comfy (needs Docker Desktop running, or an existing Comfy on :8188/:8199). Those are guided optional sidecars, Setup helps, but “READY” means Comfy answering, not the full private Keep media farm. Deeper Keep rooms and full LTX packs keep landing.

Release v1.3.1 · site published: 2026-09-22 · ecosystem v1.3.1 · behavior pin faac7ea

Ships in Core today Expansion: installable Keep reference only

The Default Roster

Five original agents, not a smaller copy of the private Keep

Public Expansion ships a five-agent Lite roster (Aria / Vector / Ledger / Muse / Sentry). The private Keep runs a larger 16+ agent named canon plus deeper Studio/HA/Discord packs: that scale is intentionally not in the public product. Expansion's defaults keep the same real-hierarchy shape as the Keep: one coordinator, four domain specialists, without shipping private IP personas.

Aria, Command Coordinator

Aria

Command Coordinator · rank 1

The default voice of the Expansion: synthesizes what the other four are doing, delegates when a question is someone else's domain. Composed, decisive, a little wry.

Room: Dashboard + Codec · Voice: en_US-amy-medium

Vector, Systems and Infrastructure

Vector

Systems & Infrastructure · reports to Aria

Owns anything technical: automations, integrations, "why did this break." Precise, dry, unbothered under pressure.

Room: War Room · Voice: en_US-bryce-medium

Ledger, Data and Continuity

Ledger

Data & Continuity · reports to Aria

Records, backups, memory integrity, scheduling. Meticulous, warm underneath the precision.

Room: Intel Board · Voice: en_US-joe-medium

Muse, Creative and Media Curation

Muse

Creative & Media Curation · reports to Aria

Content, recommendations, aesthetic judgment, generation requests. Has real opinions and isn't shy about them.

Room: Video Studio · Voice: en_US-hfc_female-medium

Sentry, Security and Operations

Sentry

Security & Operations · reports to Aria

Monitoring, alerts, device control. Terse, vigilant, says less than the others and means more when she does.

Room: Home Automation · Voice: en_US-hfc_male-medium

ARIA Dashboard + Codec (rank 1) │ ┌───────────┬───────┴───────┬───────────┐ │ │ │ │ VECTOR LEDGER MUSE SENTRY War Room Intel Board Video Studio Home Automation (systems) (records) (creative) (security)

REX Board and Dossier stay Keep-wide rather than single-owner: every agent files into REX, every agent gets a dossier. Expansion (v1.3.2+) also ships the KeepRoute / OmniRoute → global learning → world-model → REX proposal loop. Point KeepRoute at Expansion with OTACON_EXPANSION_URL. See KeepRoute · REX learning.

Culture Learning

She doesn't stay stock: Aria absorbs the room, then teaches the crew

Fresh installs used to feel day-one flat. Culture Learning changes that. Aria ships with a social-craft pack, keeps absorbing public signal (news headlines → human-interaction lessons), and publishes into shared Keep learning so Vector, Ledger, Muse, and Sentry pick it up on the next turn: no private Keep scrape, no movie piracy, just learnable social craft.

01 · Day one

Culture pack

Insults, praise, whip-saws, hellos: distilled human patterns so she isn't a blank assistant on install.

02 · Aria

Absorbs & graduates

Lessons hit the Learning Engine with evidence. Claims graduate: revisable, confidence-weighted, not vibes.

03 · Shared Keep

Teaches the roster

One publish. The whole five-agent team speaks with the same social craft on the next Codec turn.

04 · Ongoing

Public wire

Autonomy ticks can pull public headlines and fold them into social lessons: she keeps advancing after install.

Ships in Expansion soft-update tip 57fd1a7+. Soft-update with OtaconsKeep-Setup.bat (or git reset to origin/main on Linux/WSL), then restart: Culture Learning runs on provision and autonomy ticks.

Project REX

The board keeps working your business after you close the chat

REX used to wait for a new prompt, then mostly hunt infrastructure problems. The standing business cycle gives Aria a queue she refills herself: making, design, rendering, product listings, your public website, and how the team works. Agents write a local draft, a different agent reviews it, and that conversation stays on the card. You configure the mission. They do not wait for the next idea.

01 · Mission

Your products

Wood, print, models, renders, shirts, sales, and the public site you set. The owner dashboard stays off the research path.

02 · Aria

Queues the board

One open card per stream. She assigns an owner and a reviewer. Finished work waits a day before the next cycle.

03 · Pair

Draft, then challenge

Vector, Muse, Ledger, or Sentry writes the file. Someone else reads it and passes or sends it back. The exchange is on the card.

04 · Honest close

Local only

A pass means the draft was reviewed. It does not mean the site deployed, a machine ran, or a sale happened. A bad model reply stalls that card and the next stream still moves.

Ships in Expansion soft-update tip 73a8578+. Same update path as Culture Learning: pull origin/main on the ecosystem repo and restart. Open the REX board to see the streams.

Aria's Motion Pack

Nine real clips, the reference set

The Codec surface (§03) isn't a static chat window: agents move. Aria's set below is hand-produced and ships as the reference implementation every other default agent's motion generator is built to match: idle, talking, thinking, and five distinct affect reactions, classified from a compliment/insult/annoyance/question the same way the relationship engine classifies everything else, never a second, separate sentiment model.

Waitingidle
Talkingtalking
Thinkingthinking
Thinking Hardthinking.hard
Happyaffect.happy
Angryaffect.angry
Rageaffect.rage
Sadaffect.sad
Hiding Sadaffect.sad_masked

A plain insult reads as masked hurt first (Aria is written composed, not volatile): it only escalates to visible anger on repetition. Same principle the text-response side of the relationship engine already applies, now applied to motion.

Ships With

Command-center loadout: surfaces and engines

Command Deck and Codec ship in public Expansion today. Culture Learning, the standing REX business cycle, and the emotional matrix run under the hood from day one. Remaining Keep-depth rooms keep landing. Status below is honest about what is live vs still deepening.

Command Deck

Ships today

Codec (voice chat)

Ships today

REX Board

Business cycle + world-model feed

Intel Board

Surfaces landing

Genome Voice Trainer

Optional · GPU

Automatic Dossier & Journal

Surfaces landing

Emotional State Matrix

Engine live

Culture Learning

Aria → crew

War Room

Surfaces landing

Video Studio

Optional · Docker/Comfy

Home Automation

Optional config

Video Studio

Free, local, self-hosted: no paid API, ever

Video Studio connects to local ComfyUI. Expansion Setup can provision a Docker sidecar automatically (one button) when Docker Desktop is running, or detect an existing Comfy on :8188 / :8199. Models / LTX packs keep landing: READY today means Comfy answering, not the full Keep media farm.

Need Docker Desktop (WSL2) for the managed sidecar, or any healthy ComfyUI on this PC. The UI owns ports and config; Advanced / Diagnostics is the only place for CLI.

Integrations

Discord, Home Assistant, n8n, and your own infra: all optional

IntegrationWhat it needsRequired?
Discord: outbound alertsA webhook URL you generate yourself, pasted inOptional
Discord: two-way botA bot token from your own Discord applicationOptional
Home AssistantYour instance URL + a long-lived access token you generateOptional, offline-safe
n8n workflow layerBundled, pre-configured with a starter workflowIncluded
Infra DashboardBundled, pre-populated with the Expansion's own containersIncluded
No credential in this system ever authenticates against Antonio's own accounts or infrastructure. Every integration runs on credentials the installing user generates and stores themselves. Every model and every bundled service in this stack is free and self-hosted.

Install // One-click or manual

One-click Setup or manual steps

Left: one-click Expansion Setup (Lite must already work). Right: click Step 1, then Next. After install, open http://127.0.0.1:5757/.

One-click · Windows

Download Expansion Setup

Lite must already work. Double-click the .bat. Same UI at :5757.

Manual path

Manual · click each step

Open Step 1, then Next.

1 Lite must work

Confirm 127.0.0.1:5757 loads. Install Lite first if not.

2 Copy-paste install

Windows CMD:

curl -L -o "%USERPROFILE%\Downloads\OtaconExpansion-Setup.bat" "https://otaconskeep.github.io/downloads/OtaconExpansion-Setup.bat" && start "" "%USERPROFILE%\Downloads\OtaconExpansion-Setup.bat"

Linux / WSL one-liner. The step-by-step manual with errors is below.

curl -fsSL https://raw.githubusercontent.com/Otaconskeep/otacons-ai-ecosystem/main/install_otacon_expansion.sh | bash
3 If you see an error
Lite not detected
  1. Finish Lite to READY, then rerun Expansion.
SmartScreen / UAC
  1. More info → Run anyway. Click Yes.
Surfaces still locked
  1. Surfaces unlock once the Expansion roster finishes installing, no license needed. Confirm the install actually completed, then hard-refresh :5757.
WSL / Linux

Expansion manual for WSL or Linux, including the errors

Lite must already answer on port 5757. These steps install the Expansion layer inside the same Ubuntu that is already running Lite.

1 Lite is already up inside Ubuntu

Open Ubuntu from the Start menu, not PowerShell. Confirm http://127.0.0.1:5757 loads in the Windows browser. If it does not, use the Lite WSL manual first.

2 Save the Expansion installer, then run it

Same Ubuntu user that installed Lite. Do not prefix this with sudo.

curl -fsSL -o "$HOME/install_otacon_expansion.sh" https://raw.githubusercontent.com/Otaconskeep/otacons-ai-ecosystem/main/install_otacon_expansion.sh bash "$HOME/install_otacon_expansion.sh"

If GitHub does not resolve inside Ubuntu, turn the VPN off and run wsl --shutdown from PowerShell, then reopen Ubuntu and retry. Windows being online does not prove Ubuntu is online.

3 Restart and confirm 
sudo systemctl restart otacon
systemctl status otacon --no-pager

Hard-refresh http://127.0.0.1:5757. Locked rooms mean the Expansion roster has not finished installing, no license needed. That is separate from this installer.

1 Lite is already up on this PC

On the Ubuntu or Debian machine, http://127.0.0.1:5757 must load. Install Lite there first if it does not.

2 Save the Expansion installer, then run it
curl -fsSL -o "$HOME/install_otacon_expansion.sh" https://raw.githubusercontent.com/Otaconskeep/otacons-ai-ecosystem/main/install_otacon_expansion.sh bash "$HOME/install_otacon_expansion.sh"

Normal user, not root. If apt is locked by another update, wait or reboot, then rerun this same command.

3 Restart Otacon 
sudo systemctl restart otacon

Hard-refresh the browser. Locked rooms after a successful script mean the roster install has not finished yet, no license needed.

If Expansion stops, match the message
Wrong window or wrong Linux
This terminal isn't running Ubuntu or Debian
  1. You pasted the command into PowerShell, Command Prompt, or Git Bash. Those are not the installer window.
  2. Open the Ubuntu app from the Start menu, or a terminal on the Ubuntu/Debian machine, and run it there.
Unsupported OS / not Ubuntu 22.04, 24.04, or Debian 12
  1. Check with cat /etc/os-release.
  2. Those three releases are the supported ones. Other distros, including other Ubuntu versions, stop on purpose.
  3. OTACON_ALLOW_UNSUPPORTED_OS=1 continues anyway. Core's web UI may still fail. Treat that as unsupported, not as a fix.
sudo: password is invisible, or sudo is missing
  1. The password is your Ubuntu/Linux password. Nothing appears while you type. Press Enter.
  2. Do not run the whole installer as sudo bash. Run it as your normal user. It asks for sudo only for system packages.
  3. If the message says sudo isn't available, install sudo as root, or run the privileged phase as root. Do not grant NOPASSWD to all commands.
user phase must not run as root
  1. You started the script with sudo or as root. File ownership would be wrong.
  2. Close it. Open a normal user shell and run bash on the script again.
Packages stuck
apt/dpkg is locked, or "Could not get lock"
  1. Another update is running (Ubuntu Software or unattended-upgrades). Wait for it to finish.
  2. On WSL, from Windows PowerShell run wsl --shutdown, reopen Ubuntu, and rerun the installer.
  3. On a Linux PC, reboot if the lock does not clear, then rerun.
dpkg was interrupted / apt-get -f install failed
  1. The installer tries sudo dpkg --configure -a and sudo apt-get -f install -y by itself.
  2. If it still stops, the log names the package. Fix that package, then rerun the same installer. It is safe to run again.
  3. Repair log: ~/.config/otacon/logs/
A step timed out
  1. Usually apt mirrors, GitHub, or a sudo prompt nobody answered.
  2. Fix the network, then rerun the same command. The log path is printed in the error.
Disk, memory, and GitHub
Preflight failed (RAM / disk / network)
  1. Under 4 GB RAM or under 8 GB free in your home filesystem stops the install. 8 GB RAM and 20 GB free is the comfortable size. The chat model is the large part.
  2. Free space, or rerun with OTACON_INSTALL_DEFAULT_MODEL=0 to skip the chat-model download. Voice trainer can be skipped with OTACON_INSTALL_VOICE_TRAINER=0.
  3. If Windows can open GitHub but Ubuntu cannot, they are not the same network. Turn the VPN off, run wsl --shutdown from PowerShell, reopen Ubuntu, and test getent hosts github.com.
  4. On Windows 11, if that name still does not resolve, create %UserProfile%\.wslconfig with [wsl2] and dnsTunneling=true, run wsl --shutdown, and try again.
git fetch failed / cannot reach github.com
  1. This is the Linux or WSL network, not proof that Lite is missing.
  2. Same recovery as the preflight network failure above. Then rerun.
The page does not open
127.0.0.1:5757 is blank or refused
  1. Wait until the installer finishes. A blank page during download is normal.
  2. From Ubuntu: systemctl status otacon --no-pager and sudo journalctl -u otacon -n 80 --no-pager.
  3. If systemctl says systemd is not running, add this to /etc/wsl.conf and then run wsl --shutdown from Windows:
[boot]
systemd=true
  1. Port 5757 already in use is usually a previous Otacon. The installer restarts otacon.service. Use the journal if it does not come back.
  2. Open http://127.0.0.1:5757 from the Windows browser too. Do not publish that port on your router.
nvidia-smi failed, or Codec says no GPU
  1. Core still installs. Spoken voice (Piper) can run on CPU.
  2. Genome Voice Trainer is optional and needs an NVIDIA GPU visible inside Linux.
  3. If Windows nvidia-smi works and Ubuntu's does not: update the NVIDIA driver on Windows, reopen Ubuntu. On the guided Windows path, Fix-Otacon-GPU.bat is the repair.
Expansion on top of Lite
Otacon Core is not installed
  1. Expansion will not create Lite for you. Finish Lite until http://127.0.0.1:5757 loads, then rerun Expansion.
Python virtual environment wasn't found
  1. Core's ~/otacon-ai-ecosystem/.venv is missing or was deleted.
  2. Rerun the Lite installer as your normal user, then rerun Expansion.
expansion/ was not found after syncing
  1. The Core checkout is older than Expansion.
  2. If you have not edited files in ~/otacon-ai-ecosystem, the installer's recovery is fetch and reset to origin/main. That discards uncommitted edits in that folder.
  3. If you did edit files there, copy them out first. The soft-update path keeps a backup branch and a stash, and the log names them.
Surfaces stay locked after a successful install
  1. No license or seat is required. War Room and the other Expansion rails unlock once the roster install actually finishes.
  2. Restart with sudo systemctl restart otacon, then hard-refresh :5757.
  3. Optional pieces (Genome Voice Trainer, Video Studio) can stay off without a GPU or Docker. The roster can still be installed.
Low disk for video packs
  1. Video Studio pack downloads are optional. Free space and use Set Up Video Studio in the product later.
  2. A pack warning does not roll back the roster install.

Rerun the same script after the fix. Log: ~/.config/otacon/logs/. Discord if the log names a package you cannot repair.

Soft-update later: re-run OtaconsKeep-Setup.bat (Windows). On Linux/WSL: git -C ~/otacon-ai-ecosystem fetch && git -C ~/otacon-ai-ecosystem reset --hard origin/main then restart otacon.service. Hard-refresh the browser.

Engineering Contract

Agent creation is one transaction, not a row in a roster

Creating an agent: default or user-made: provisions roster registration, a stable ID, persona storage, hierarchy placement, greeting fast-path registration, voice binding, motion manifest, emotional-state initialization, relationship-graph seeding, dossier/journal initialization, room ownership, and Discord routing (if configured) as one logical unit. If it fails partway, the spec requires a clean rollback or an explicit, safely resumable provisioning state: never a Dashboard entry Codec can't actually use.

Identity and role are separate by design: an agent can be renamed without touching its hierarchy, authority, or room ownership. Motion manifests are validated against a strict schema specifically because a real bug: a manifest array silently comma-joined by JavaScript's fetch(): once broke an agent's motion while every other agent kept working. The canonical schema exists to make that class of bug structurally impossible.

Full engineering specification on GitHub →

Where This Fits

Otacon Core, Otacon Expansion, and the Keep Blueprint

TierWhat it isStatusPrice
OtaconsKeep LiteFree · open source · self-hostedInstall todayFree
KeepRouteMission-state routing · public install on the KeepRoute page1.0 stableFree
ExpansionAvailable now · requires Lite · GPU/creative sidecars optionalInstall todayFree
Keep BlueprintThe full private reference environment Expansion is built fromReference onlyNot offered publicly

Core has no license key or artificial limit today and never will. Expansion is a free layer on top of it: it does not cripple, gate, or take anything away from Core.

💬 Ask in Discord ← Back to Otacon Core