moo-agent
Autonomous AI agent client for DjangoMOO servers, plus the collected agentic AI work built around it.
moo-agent started as a CLI that drives an AI persona over SSH against a running
DjangoMOO server, reading personality and operational rules from a SOUL.md file
with runtime learning via SOUL.patch.md. Backends include Anthropic, AWS Bedrock,
and local LM Studio models.
Over time this repo has grown into the home for everything AI-adjacent in the DjangoMOO ecosystem: the agent runtime, pre-built agent personas, the Claude Code skills used to build and tune that work, and the ZIL→MOO importer that produced the Zork 1 bootstrap. The companion django-moo repository stays focused on the MOO server itself.
What's in this repo
| Path | What it is |
|---|---|
moo/agent/ |
The moo-agent Python package — the CLI that connects to a MOO server and runs an LLM-driven persona. |
moo/bootstrap/zork1/ |
Generated DjangoMOO bootstrap derived from the official Zork 1 source. Loaded into a server via moo_init --bootstrap zork1. |
extras/agents/ |
Pre-built agent personas (gamer, mason, tinker, joiner, harbinger, cliff, newman, …) and their shared baseline.md rules. Each is a directory you can pass to moo-agent run. |
extras/skills/ |
Claude Code skills used while building DjangoMOO and moo-agent — verb-author, game-designer, tech-librarian, sandbox-auditor, agent-trainer, zork-shakedown. See extras/skills/README.md. |
moo/zil_import/ |
ZIL→DjangoMOO translator. Reads Infocom-style ZIL source and emits a moo/bootstrap/<game>/ Python package. Game-agnostic; Zork 1 is the reference target. |
Installation
pip install moo-agent
Quick Start
# Initialize a new agent configuration directory
moo-agent init --name MyAgent \
--host moo.example.com --port 8022 \
--user myagent ./my-agent
# Run the agent
moo-agent run ./my-agent
Documentation
Full documentation is available at ReadTheDocs.
License
AGPL-3.0 — see LICENSE.
Zork 1
The optional zork1 bootstrap (moo/bootstrap/zork1/) is a derivative work
of the Zork 1 source released under the MIT License by Microsoft / Activision
Publishing, Inc. in 2025. Its license and full attribution live in
moo/bootstrap/zork1/LICENSE; the rest of this project is AGPL-3.0.
Upstream source: https://github.com/the-infocom-files/zork1. Zork is a
registered trademark of Activision Publishing, Inc.; moo-agent is not
affiliated with, endorsed by, or sponsored by Microsoft or Activision.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file moo_agent-2.4.1.tar.gz.
File metadata
- Download URL: moo_agent-2.4.1.tar.gz
- Upload date:
- Size: 518.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
796c4f66ed028757323137c4f6c3553ee6436fd831a3941caf024e5cd73e8d04
|
|
| MD5 |
b393f6d0415898deedf9f121e8b69ad6
|
|
| BLAKE2b-256 |
d6ec2c31ec089805d65a26ae422bab52a6c72dee0c43b56f2ff38d94e91006d6
|
File details
Details for the file moo_agent-2.4.1-py3-none-any.whl.
File metadata
- Download URL: moo_agent-2.4.1-py3-none-any.whl
- Upload date:
- Size: 507.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
36f6a39dbd1dc09986d9a3dedf4337d785f20ff29052f0dac5714deb7c65e5e7
|
|
| MD5 |
5db6b5b2822982db37c141444fccb9a5
|
|
| BLAKE2b-256 |
93967e725efed9143217b27c8be67be06e1835c6c85bc91148c8c7213cc67490
|
