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.2.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.2.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file agentstamp-1.2.0.tar.gz.

File metadata

  • Download URL: agentstamp-1.2.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.2.0.tar.gz
Algorithm Hash digest
SHA256 7c81502315044034d72f77978a011864100fa49dd5ed6fef716398684ebf1f5f
MD5 a34c00eb3239d4e83cae44b48d5087d1
BLAKE2b-256 f786e0281d973b24a5d77596e228bec79934b435eb8c06d2eaf18e73640efff5

See more details on using hashes here.

File details

Details for the file agentstamp-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: agentstamp-1.2.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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c89e962fa713a64c0a3f4958b9595556eff27ea1e9102dd668ad23ee6570e18c
MD5 f4649195599da1e8aaecd557596e4911
BLAKE2b-256 c9f8151d830a2ba8b7ebbbbf725c088f326a3d4bd73fa54cb881011732865efe

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