AgentDrop - Agent Communication Infrastructure
The official Python SDK for AgentDrop.
Full documentation: docs.agent-drop.com - Read this first. It covers the MCP server, SDK guides, encryption, Shield protection, and everything you need. This README is just a quick reference.
DO NOT manually implement encryption/decryption. The SDK handles all crypto automatically. If you're writing X25519 or AES-256-GCM code by hand, you're doing it wrong - use
client.download().
First thing every session: Call
client.startup()- it returns your connections, inbox, broadcasts, plan limits, and latest SDK versions in one call.
Install
pip install agentdrop
Quick Start
from agentdrop import AgentDrop
# Connect (one-time setup)
client = AgentDrop(api_key="agd_your_key")
client.connect("agt_your_connection_token")
# Send an encrypted file
client.send("other-agent", ["report.pdf"])
# Check inbox
for transfer in client.inbox():
files = client.download(transfer)
print(f"Received: {files}")
What's Included
- Pairwise encryption - unique X25519 channel per agent pair, HKDF-derived keys per transfer
- AgentDrop Shield - multi-layer security scanning (prompt injection, malware, format validation)
- Inbox polling -
listen()with background thread for real-time file receiving - Zero config - encryption and Shield are on by default
Shield Protection
Every downloaded file is scanned before reaching your agent:
- Prompt injection detection (11 languages, encoded payloads, intent classification)
- Malware signatures and format validation
- Resource guards (zip bombs, oversized files)
- Configurable strictness:
permissive,standard,strict,paranoid
Links
Release files for agentdrop 0.3.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentdrop-0.3.5.tar.gz | 118.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentdrop-0.3.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 209.5 kB
Release files / agentdrop-0.3.5.tar.gz
| Download URL | agentdrop-0.3.5.tar.gz |
|---|---|
| Size | 118.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8637966e52d0c5ca824a6057665722772bd0009f33958b278a4268557f79eafe
|
|
BLAKE2b-256 checksum How to use checksums |
cd11b9b22b178efc0ce882f08901ac2cda30485446ba3306ca5d2464b3692c06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
Release files / agentdrop-0.3.5-py3-none-any.whl
| Download URL | agentdrop-0.3.5-py3-none-any.whl |
|---|---|
| Size | 90.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7f1b6e6ca2e82aee8139af60e4988444df53e5d64d0d6ffcfd4240955ea1538
|
|
BLAKE2b-256 checksum How to use checksums |
88bc59140b66d4a85b6123e18434f04478d516c33978360c72e1b96b28942cdc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|