dryade-plugins-sdk

Pure-Protocol Python SDK for authoring Dryade plugins.
Zero host-runtime imports. Hash-conformant. MIT-licensed.

Why dryade-plugins-sdk

• Sovereign — author plugins that ship to self-hosted Dryade installs. No cloud lock-in.
• Type-safe — Python Protocol + @runtime_checkable. Your IDE catches contract violations before runtime does.
• Hermetic — develop and test plugins without installing Dryade. The SDK ships its own test fixtures.

Quickstart

uv tool install 'dryade-plugins-sdk[cli]'
dryade plugin new my_plugin --tier starter
cd my_plugin
dryade plugin validate
dryade plugin package

Five commands. Your .dryadepkg is ready to submit to the Dryade marketplace or share directly.

Full guide: dryade.ai/docs/sdk/getting-started

Used by

The Dryade team's first-party plugins are authored with this SDK. Browse the examples directory for 5 reference plugins covering tools, LLM calls, UI bundles, and multi-agent patterns.

Examples

• hello_world/ — minimal Plugin skeleton
• with_tool/ — register a tool the host LLM can call
• with_llm/ — tool that calls the host LLM via the Leash protocol
• with_ui/ — ships a React UI bundle the workbench mounts
• multi_agent/ — two agents collaborate via shared KV

Start a new plugin from the template starter repo:

gh repo create my-plugin --template DryadeAI/dryade-plugin-template

Documentation

• dryade.ai/docs/sdk/ — full docs site (Getting Started, Concepts, API Reference, CLI Reference, Cookbook, FAQ, Migration)
• Security model for authors — what you MUST know about hashing, signing, and tier slots
• Contract version — current SDK CONTRACT_VERSION and how it gates compatibility

Community

• Discord — GitHub Discussions — ask questions, share what you built
• GitHub Discussions — Q&A · Show & Tell · Ideas
• Twitter/X — follow @DryadeAI for SDK announcements

Contributing

We welcome contributions. Start with CONTRIBUTING.md. Good first issues are labeled good first issue.

Star History

Reporting security issues

See SECURITY.md. Do not file public issues for vulnerabilities — use GitHub Security Advisories or email security@dryade.ai.

Publishing to the marketplace

Authoring a plugin is free. Submitting it to the Dryade marketplace is free. Where you'll see numbers:

• Listing — free for every tier. There is no per-listing fee.
• Free / community plugins — list and distribute at no cost. Author keeps full attribution; no revenue share.
• Paid plugins (team and enterprise tiers) — Dryade takes a 30% platform fee; the author keeps 70% of net (after payment processor + tax).
• Payouts — monthly via Stripe Connect once your accumulated balance crosses $50. Authors in non-Stripe geographies can opt into bank transfer at the same threshold.
• Review SLA — first submission: 5 business days. Updates to an already-approved plugin: 24 hours. Security patches: expedited to next business day.

The review checks: manifest validates against the v2 schema; the .dryadepkg is signed with a registered author key; the plugin passes the smoke test in examples/; no leaks of internal Dryade symbols or credentials.

For exact terms, marketplace SLAs, or large-deal carve-outs (volume rebates, enterprise reseller, sovereign deployments): email licensing@dryade.ai.

License

MIT. Use it, modify it, ship it — no Dryade approval needed. See LICENSE for full terms.

Contributors