Dryade plugin SDK — Protocol contracts and author tooling primitives
Project description
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/— minimalPluginskeletonwith_tool/— register a tool the host LLM can callwith_llm/— tool that calls the host LLM via the Leash protocolwith_ui/— ships a React UI bundle the workbench mountsmulti_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_VERSIONand 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
Project details
Release history Release notifications | RSS feed
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 dryade_plugins_sdk-1.1.5.tar.gz.
File metadata
- Download URL: dryade_plugins_sdk-1.1.5.tar.gz
- Upload date:
- Size: 68.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb6d6967877286164533759fdd1feb5aa6d82854de507317ec1bf7593a2cf4bf
|
|
| MD5 |
ef046c9fe8afb5a055d387c5f4514c63
|
|
| BLAKE2b-256 |
9e1874eefabad4c703309ddb2fdaec9b8a7ee4190ce8dc8259f1984d842bf874
|
Provenance
The following attestation bundles were made for dryade_plugins_sdk-1.1.5.tar.gz:
Publisher:
publish.yml on DryadeAI/dryade-plugins-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dryade_plugins_sdk-1.1.5.tar.gz -
Subject digest:
eb6d6967877286164533759fdd1feb5aa6d82854de507317ec1bf7593a2cf4bf - Sigstore transparency entry: 1634761724
- Sigstore integration time:
-
Permalink:
DryadeAI/dryade-plugins-sdk@33ca60e92dfec06a6ed810a90e6f031ec008a9b7 -
Branch / Tag:
refs/tags/v1.1.5 - Owner: https://github.com/DryadeAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@33ca60e92dfec06a6ed810a90e6f031ec008a9b7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file dryade_plugins_sdk-1.1.5-py3-none-any.whl.
File metadata
- Download URL: dryade_plugins_sdk-1.1.5-py3-none-any.whl
- Upload date:
- Size: 61.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d8ba41b7ecdd36ab7ceb372bd57faed7a05203d1bd13b280d0dc2dad5b327fbc
|
|
| MD5 |
ac38d18c9ed15bf21213dab29806111f
|
|
| BLAKE2b-256 |
6d9b12d458e7c1947fd1f9b26915cfca05f60e3ff3125fefee1adb409b35dc66
|
Provenance
The following attestation bundles were made for dryade_plugins_sdk-1.1.5-py3-none-any.whl:
Publisher:
publish.yml on DryadeAI/dryade-plugins-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dryade_plugins_sdk-1.1.5-py3-none-any.whl -
Subject digest:
d8ba41b7ecdd36ab7ceb372bd57faed7a05203d1bd13b280d0dc2dad5b327fbc - Sigstore transparency entry: 1634761874
- Sigstore integration time:
-
Permalink:
DryadeAI/dryade-plugins-sdk@33ca60e92dfec06a6ed810a90e6f031ec008a9b7 -
Branch / Tag:
refs/tags/v1.1.5 - Owner: https://github.com/DryadeAI
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@33ca60e92dfec06a6ed810a90e6f031ec008a9b7 -
Trigger Event:
push
-
Statement type: