Skip to main content

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:

![AgentStamp](https://agentstamp.org/api/v1/badge/0xYourWallet)

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentstamp-1.1.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentstamp-1.1.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

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

Hashes for agentstamp-1.1.0.tar.gz
Algorithm Hash digest
SHA256 bdffed80eee298590f765c268a0bb877466c2d19ee4d42bf0fa7ac4c84f0c02a
MD5 9a462cd27362267a3991a3a4fe45b33d
BLAKE2b-256 732a747b073f1a69b4fbff1db1ce11b63bb842350c11225903522a9041788c29

See more details on using hashes here.

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

Hashes for agentstamp-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 42256240c9eafaa5f9e5a697a7c1eaaddf2dacb872f300c9da13b35b54f733be
MD5 c41ca1fdc3927de5ff9a7f431f9321e7
BLAKE2b-256 4bf3d50fb6402c9c0acd9b04ae8984a4faa2550eb0feff3d5c8d6d997631967d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page