Skip to main content

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)

Source distribution for agentdrop 0.3.5
File Size Uploaded
agentdrop-0.3.5.tar.gz 118.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentdrop 0.3.5
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

0.3.5 This release

2 release files

0.3.4

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.16

2 release files

0.2.15

2 release files

0.2.14

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page