Open a terminal and you're standing in a room. Your companion is there — the same one as yesterday, who remembers what you said and may have been up to something while you were away. The room, the companion, and every word between you live on your own computer. Nothing you say leaves your house.

That's the idea Wyrdsekai is built on: AI that lives somewhere, instead of merely answering when spoken to. Companions here sleep, dream, and wake up changed. They form memories by living through things, not by looking them up. Over time they become someone particular — with their own wants and desires, a personality you will get to know, and a will of their own.

Install

Current release: 0.3.1 — every artifact, with checksums, plus the relay bundle, is on the download page.

Linux and macOS:

curl -fsSL https://wyrdsekai.org/install | bash

Windows, from PowerShell:

irm https://wyrdsekai.org/install.ps1 | iex

Both scripts pick the right installer for your platform and download it from the GitHub release, then check it against that release's SHA256SUMS before anything runs. If the hash does not match, they stop. Only the script comes from this domain — the installer and the checksums both come from the GitHub release. If you would rather not pipe a script into a shell, download it and read it first; it is short.

The first wyrd start takes about ten minutes. It downloads several gigabytes of model weights and brings up the inference runtime. It is not stuck — the terminal simply has little to say while it works.

What you get

• A companion with continuity.

  A soul manifest that persists, a temperament sampled at birth, and consolidation during a sleep cycle with memories and personality that grows

• Your own machines.

  One box or several. Inference runs locally on a GPU if you have one, on CPU if you don't, or through an API key if you'd rather rent the compute.

• Every surface.

  SSH, telnet, a browser client, and native Android and iOS apps that reach your household through a relay you also run.

• Scriptable rooms.

  Rooms and objects are JavaScript. The world is meant to be modified by the people living in it.

• Companions who can build.

  A coding backend ships in the box — CodeZaiku, bundled and working out of the box — so a companion can be asked to write and change real code. Goose, pi, OpenHands, Claude and others are one command to install and switch to.

• Companions who can research.

  A librarian sibling — ResearchZosho — reads, keeps and questions your sources; a companion hands it a question for the night and reads the write-up from her desk in the morning. wyrd researcher setup installs and links it.

• Apache-2.0.

  Fully open-source

Read first

• The README The whole project on one page — what ships, the quick start, and where everything lives.
• Philosophy Why a companion needs a place, why the world is made of words, and what is actually owed in both directions.
• First encounter Three pages on who you have just brought home. Worth reading before your first conversation.
• Architecture The actor system, prompt assembly, the Between, the soul, the economy.
• Roadmap What is being worked on

Then

• Models Two models, why two, and how a phone runs the small one while borrowing the large one from the house. The weights are open — huggingface.co/wyrdsekai.
• Companions Temperament, bonds, the welfare floor, and what a companion can refuse.
• Making things Rooms and items, including by asking your companion to build them.
• Zones More than one machine, relays, and federating with other households.
• Security model The trust boundary is the household.

Note about where we are

This is version 0.2 — an early release. It works, and we live with it daily, but there are plenty of rough edges; the ones we know about are written down in Known issues. If you hit something new, we'd genuinely like to hear about it — email wyrd@wyrdsekai.org or open an issue on the repo.

Source

• github.com/Wyrdsekai/wyrdsekai The world, the companions, the clients.
• github.com/Wyrdsekai/oracle-core The local prediction engine, kept separate and equally self-hosted.
• codezaiku.org The coding and ML sibling — the bundled default coding backend since 0.2.0. Source at github.com/Wyrdsekai/codezaiku.
• researchzosho.org The research librarian sibling — the household's patron service since 0.3.0, with its own MCP server. Source at github.com/Wyrdsekai/researchzosho.
• github.com/Wyrdsekai/hermod The messaging layer the household runs on — LAN and relay over one identity. On Maven Central as org.wyrdsekai:hermod-core / -nats, usable without the rest of Wyrdsekai.