Spawn AI agents
from files.

Stack tools, skills, and memory into reproducible worlds. One file, runs anywhere. Open-source.

🦞
spwn
$Β spwn agent neo
βœ“
Worldworld-matrix-90042
βœ“
Agentneo
βœ“
SoulSOUL.md (the-one)
βœ“
Status● awake. Welcome to the real world.
βœ“
He is beginning to believe.
$Β What will you create?

Models are getting smarter. The places they live in haven't caught up.

Read the manifesto→
Compose

Two agents, two worlds.

Same project, different stacks. Every agent gets the sandbox its job needs, not the sandbox everyone else got.

spwn.yamlneospwn:pythonspwn:postgresskill/testsruns testscuriespwn:nodetool/ffmpegskill/encodecompiles video
# spwn/agents/neo/agent.yamlneo
dependencies:
  - "spwn:python"
  - "spwn:postgres"
  - "skill/tests"
# spwn/agents/curie/agent.yamlcurie
dependencies:
  - "spwn:node"
  - "tool/ffmpeg"
  - "skill/encode"

One spwn up. Two containers. Zero overlap.

The source code of an environment.

Every block is a file. Agents declare what they need, worlds declare how they run. Stack them, override them, share them like Dockerfiles for minds.

Add a dep, gain a capability.

# spwn/agents/neo/agent.yamlAgent
name: neo
runtime:
  backend: spwn:claude-code

dependencies:
  - spwn:unix
  - spwn:git
  - spwn:python
  - skill/code-review

Declare it. spwn up runs it.

# spwn.yamlWorld
version: 2
name: acme-api

worlds:
  matrix:
    agents: [neo]
    workspaces: [.]
    knowledge: ./spwn/knowledge

β€œThe next breakthrough isn't smarter models. It's richer worlds.”

The real power of AI isn't the model. It's the model plus everything around it. Oppenheimer in a chatbox can answer questions. Oppenheimer in a lab, surrounded by instruments, notebooks, colleagues, and years of memory, can change the world. The environment is the multiplier.

The Stack

From your laptop down to the agent's core.

Every layer is a spwn contract. Host, architect, world, agent; declared in code, deployed by spwn up, torn down by spwn down.

HostYour machineArchitectThe ArchitectWorldIsolated runtimeDockerSoulAgentSoulMindDepsDreamsSleepsForksActsObservesGate
Features

Every block is a file.

Not a wrapper. Not a framework. Composable primitives a PR can review.

agent.yamlsourcecommitsagent

🧾Agents orchestration as code

Commit agents alongside your app, review behavior changes in PRs, ship the same mind to every machine.

spwn:pythonspwn:qmdtool/ffmpegsandboxstackworld

πŸ› οΈComposable environment

Stack spwn:python, spwn:qmd, tool/ffmpeg, whatever your agent needs. Each one wakes up in a sandbox assembled for its job.

⎈a1b6d9cidenticalidenticalidentical

πŸ“¦Reproducible

One spwn build, one portable artifact. Byte-identical on every machine, every time.

worlds

πŸͺWorlds

Bundle agents, workspaces, and knowledge. spwn up deploys them together, spwn down tears it all down.

agents/neo/on diskSOUL.md12 Aprplaybooks/14 Aprjournal/todaysurvives restarts

🧠Persistent

Memory is a folder of markdown files. Readable, diffable, alive across restarts.

$ spwn checkβœ“spwn:pythonβœ“skill/code-reviewβœ—tool/missing-refnot foundβœ“hook/session-startcaught before spawn1 error

🧐Checked

spwn check surfaces bad refs, missing files, and lockfile drift before you spawn anything.

Spawn your first world.

One command. No account. Runs on your machine.