PyNydus

PyNydus is a tool designed to facilitate portable state transport for AI agents by packaging agent state into a portable artifact called an Egg. egg ZIP archive on disk. The system allows users to move agent state between different frameworks without manual migration, addressing the challenge of transferring complex agent configurations and data across environments.

A core feature of PyNydus is its process for handling sensitive information: secrets and personally identifiable information (PII) are redacted before the agent state is packaged, and then restored when the Egg is unpacked in a new environment. The tool supports spawning an Egg from existing agent projects, including those based on OpenClaw, ZeroClaw, or Letta, and hatching the Egg into any supported target runtime. md. For integrity, Eggs can be signed using Ed25519 and shared via the Nest registry.

PyNydus introduces the Nydusfile, a small domain-specific language (DSL) file that declares what to spawn, including the source type, redaction settings, and merge operations. The tool can be installed via pip and is used programmatically through its Python SDK. The workflow involves reading source files, redacting sensitive data, parsing the agent structure, and packaging it into an Egg, which can then be saved and later hatched into a specified runtime with resolved secrets and output files written to disk.

The platform provides a range of modules and APIs for configuration, security, connectors, and agent management, as indicated by its internal structure and documentation. PyNydus is positioned as a framework and SDK for managing AI agent state portability and integrity across different ecosystems.