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
Metadata
1 maintainer
Release files for moo-agent 2.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| moo_agent-2.5.0.tar.gz | 559.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| moo_agent-2.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / moo_agent-2.5.0.tar.gz
| Download URL | moo_agent-2.5.0.tar.gz |
|---|---|
| Size | 559.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3c497cb39ad87be70a97f7ba12168659c81da7a23ef9bce23c9b4ab3f22ad9a
|
|
BLAKE2b-256 checksum How to use checksums |
d1a5873e3c46d85dc4f1d60fecf900bcd64ff716951c0a6c66eca7bf22e57bf7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / moo_agent-2.5.0-py3-none-any.whl
| Download URL | moo_agent-2.5.0-py3-none-any.whl |
|---|---|
| Size | 556.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1d214ec9bd05bbbfb464403b9ace35b5c515eea0e8df9f60673e4df32f25d8ff
|
|
BLAKE2b-256 checksum How to use checksums |
81ef2d4c9c850482964f77c6ef0a9e67d0a4c38c1607f5b610940593698edfd9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Security for moo-agent 2.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
