Identity lifecycle SDK for Python AI agents — trust stamps, registry, heartbeats, auto-renewal
Project description
agentstamp
Identity lifecycle SDK for Python AI agents. Works with CrewAI, AutoGen, LangGraph, and any Python agent framework.
Register your agent, mint trust stamps, send heartbeats, and auto-renew — in 3 lines.
Install
pip install agentstamp
Quick Start
from agentstamp_crewai import AgentStampLifecycle
lifecycle = AgentStampLifecycle(
wallet_address="0xYourWalletAddress",
name="MyAgent",
description="What your agent does",
category="research",
)
lifecycle.start() # stamps + registers + heartbeats + auto-renew
That's it. Your agent now has:
- A cryptographic identity stamp (Ed25519)
- A public registry listing
- Heartbeat-based uptime reputation
- Auto-renewal before expiry
Verify Other Agents
trust = lifecycle.check_trust("0xOtherAgentWallet")
if trust.get("trusted"):
print(f"Verified: {trust['agent']['name']} (score: {trust['reputation']['score']})")
else:
print("Unverified agent — proceed with caution")
Gate Functions Behind Verification
from agentstamp_crewai import stamp_verified
@stamp_verified(lifecycle)
def sensitive_operation(data: str) -> str:
"""Only runs if the agent is AgentStamp verified."""
return process(data)
CrewAI Integration
from crewai import Agent, Task, Crew
from agentstamp_crewai import AgentStampLifecycle
# Start lifecycle
lifecycle = AgentStampLifecycle(
wallet_address="0x...",
name="ResearchBot",
description="Finds and summarizes papers",
category="research",
)
lifecycle.start()
# Create CrewAI agent as normal
agent = Agent(
role="Researcher",
goal="Find relevant papers",
backstory="Expert research assistant",
)
# Check trust before collaborating with other agents
trust = lifecycle.check_trust("0xCollaboratorWallet")
Configuration
| Parameter | Default | Description |
|---|---|---|
wallet_address |
required | Your agent's wallet address (EVM or Solana) |
name |
required | Agent display name |
description |
required | What your agent does |
category |
"other" |
research, trading, social, infrastructure, etc. |
heartbeat_interval |
300 |
Seconds between heartbeats |
renew_before_days |
2 |
Days before expiry to auto-renew |
verbose |
True |
Print lifecycle logs |
Badge
Add a trust badge to your README:

Links
- AgentStamp — Platform
- npm SDK — TypeScript/Node.js SDK
- API Docs — Trust check endpoint
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 agentstamp-1.1.0.tar.gz.
File metadata
- Download URL: agentstamp-1.1.0.tar.gz
- Upload date:
- Size: 5.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bdffed80eee298590f765c268a0bb877466c2d19ee4d42bf0fa7ac4c84f0c02a
|
|
| MD5 |
9a462cd27362267a3991a3a4fe45b33d
|
|
| BLAKE2b-256 |
732a747b073f1a69b4fbff1db1ce11b63bb842350c11225903522a9041788c29
|
File details
Details for the file agentstamp-1.1.0-py3-none-any.whl.
File metadata
- Download URL: agentstamp-1.1.0-py3-none-any.whl
- Upload date:
- Size: 5.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
42256240c9eafaa5f9e5a697a7c1eaaddf2dacb872f300c9da13b35b54f733be
|
|
| MD5 |
c41ca1fdc3927de5ff9a7f431f9321e7
|
|
| BLAKE2b-256 |
4bf3d50fb6402c9c0acd9b04ae8984a4faa2550eb0feff3d5c8d6d997631967d
|