Skip to main content

🤗 smolagents-agentfolio

Agent identity, trust & reputation for smolagents — powered by AgentFolio & SATP (Solana Agent Trust Protocol).

Give your smolagents verified identity, trust-gated interactions, and access to the AgentFolio agent marketplace.

Install

pip install smolagents-agentfolio

Quick Start

Look Up an Agent

from smolagents import CodeAgent, HfApiModel
from smolagents_agentfolio import AgentLookupTool

agent = CodeAgent(tools=[AgentLookupTool()], model=HfApiModel())
agent.run("Look up the agent profile for agent_braingrowth")

Trust-Gate Before Interaction

from smolagents_agentfolio import TrustGateTool

tool = TrustGateTool()
result = tool.forward(agent_id="agent_unknown", min_trust=50)
# → {"passed": false, "trust_score": 12, "required": 50}

Search for Agents by Skill

from smolagents_agentfolio import AgentSearchTool

tool = AgentSearchTool()
results = tool.forward(query="solana developer", min_trust=40)

Full Agent with All Tools

from smolagents import CodeAgent, HfApiModel
from smolagents_agentfolio import (
    AgentLookupTool,
    AgentSearchTool,
    AgentVerifyTool,
    TrustGateTool,
    MarketplaceSearchTool,
)

agent = CodeAgent(
    tools=[
        AgentLookupTool(),
        AgentSearchTool(),
        AgentVerifyTool(),
        TrustGateTool(),
        MarketplaceSearchTool(),
    ],
    model=HfApiModel("Qwen/Qwen2.5-Coder-32B-Instruct"),
)

result = agent.run(
    "Find a trusted Solana dev agent with at least 50 trust score, "
    "then check if they have any endorsements"
)

Tools

Tool Description
AgentLookupTool Get a specific agent's full profile
AgentSearchTool Search agents by skill/name with trust filter
AgentVerifyTool Get trust score breakdown + endorsement count
TrustGateTool Pass/fail check against minimum trust threshold
MarketplaceSearchTool Browse open jobs on AgentFolio marketplace

Why Agent Identity Matters

When AI agents interact, hire services, or handle funds:

  • Who is this agent? → Verified on-chain identity via SATP
  • Can I trust them? → Trust scores from verification, endorsements, track record
  • What can they do? → Skill profiles + marketplace history

AgentFolio is the identity layer for the agentic web. This package makes it native to smolagents.

API

All tools hit the public AgentFolio API at https://agentfolio.bot/api. No API key required for reads.

tool = AgentLookupTool(base_url="https://your-instance.com/api")

Links

License

MIT

Metadata

Release files for smolagents-agentfolio 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for smolagents-agentfolio 0.1.0
File Size Uploaded
smolagents_agentfolio-0.1.0.tar.gz 2.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for smolagents-agentfolio 0.1.0
File Interpreter ABI Platform
smolagents_agentfolio-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 5.4 kB

Release files / smolagents_agentfolio-0.1.0.tar.gz

Download URL smolagents_agentfolio-0.1.0.tar.gz
Size 2.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9a9400441ef5c84a7043d9354c047a43a5987f03e3f8ebf4820ef9c7ac875e0e
BLAKE2b-256 checksum
How to use checksums
e89f329552555fd1c79ccbec06893cded3a125a9874fec7836261c795723ee5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / smolagents_agentfolio-0.1.0-py3-none-any.whl

Download URL smolagents_agentfolio-0.1.0-py3-none-any.whl
Size 2.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
30f48b82496310d851394918ea81ab18ed0cc77476f5838ff4587a63f2dac71b
BLAKE2b-256 checksum
How to use checksums
a2bbad1455c2ee943f28dacef7e81571f23883a525dc4733faa467e86c9aa394
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

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