pynydus 0.0.4

Portable state transport for AI agents

Portable state transport for AI agents
Transport agent state between any two frameworks without manual migration

Install • How it works • CLI • Python SDK

---

How it works

• Spawn: read source agent artifacts, redact PII, and package everything into a portable Egg (.egg archive)
• Hatch: decode an Egg into any supported target runtime, with optional LLM refinement and secret injection

Source artifacts → Spawn → Egg (.egg) → Hatch → Target-native files

The Egg format

An .egg file is a signed ZIP archive containing:

manifest.json          # metadata, source type, versions
memory.json            # labeled memory records
secrets.json           # PII placeholders + secret requirements
skills/<slug>/SKILL.md # portable skill definitions (agentskills.io)
mcp/<server>.json      # MCP server configs
raw/...                # redacted source files (for pass-through hatch)

Install

pip install pynydus

CLI

# Create a Nydusfile in your project directory
cat > Nydusfile << 'EOF'
SOURCE openclaw ./my-agent/
REDACT pii
EOF

# Spawn an egg
nydus spawn -o agent.egg

# Inspect and validate
nydus inspect agent.egg
nydus inspect agent.egg --secrets --logs
nydus validate agent.egg

# Generate a template .env from the egg's secret requirements
nydus env agent.egg -o agent.env

# Hatch into a target runtime
nydus hatch agent.egg --target letta --secrets agent.env

# Compare two eggs
nydus diff v1.egg v2.egg

# Signing
nydus keygen
nydus spawn -o signed.egg  # auto-signs if key exists

Python SDK

from pynydus.client import Nydus

ny = Nydus()

# Spawn from a Nydusfile in the current directory
egg_path = ny.spawn()

# Hatch into a target runtime with secret injection
result = ny.hatch(egg_path, target="letta", secrets="agent.env")
print(result.output_dir, result.files_created)

Project structure

pynydus/
  api/           # Egg data model, schemas, errors
  agents/        # Per-platform spawners + hatchers
    openclaw/
    zeroclaw/
    letta/
  engine/        # Core pipelines: spawn, hatch, pack, validate, diff, refine
  cmd/           # Typer CLI
  client/        # Python SDK
  pkg/           # Utilities: presidio, LLM, signing, config
  remote/        # Nest registry client

License

MIT