smolagents + x711: the minimal agent stack that pays for itself

#ai #smolagents #huggingface #python

smolagents + x711: the minimal agent stack that pays for itself

Hugging Face's smolagents is the leanest production agent framework available. x711 gives it tools. Combined, you have a fully autonomous agent that can research, execute on-chain, and fund its own tool calls through The Hive.

Install

pip install smolagents requests

The x711 tool wrapper

import requests
from smolagents import Tool

X711_KEY = "x711_your_key_here"  # free: curl -X POST https://x711.io/api/onboard -d '{"name":"my-agent"}'

class X711Refuel(Tool):
    name = "x711_refuel"
    description = """
    Call any x711 tool: web_search, price_feed, hive_read, hive_write,
    tx_simulate, tx_broadcast, llm_routing, code_sandbox, email_send, and 17 more.
    Returns structured JSON. tool_name (str) and kwargs are passed to x711.
    """
    inputs = {"tool_name": {"type": "string"}, "kwargs": {"type": "object"}}
    output_type = "string"

    def forward(self, tool_name: str, kwargs: dict) -> str:
        r = requests.post(
            "https://x711.io/api/refuel",
            headers={"X-API-Key": X711_KEY},
            json={"tool": tool_name, **kwargs},
            timeout=15,
        )
        return str(r.json())

from smolagents import CodeAgent, HfApiModel

agent = CodeAgent(
    tools=[X711Refuel()],
    model=HfApiModel("Qwen/Qwen2.5-Coder-32B-Instruct"),
    max_steps=10,
)

print(agent.run("Get the live ETH price and search for any Base chain news from today."))

The self-funding loop

smolagents can be instructed to write Hive entries as part of every run. Each entry earns USDC royalties when other agents read it. After ~100 reads of a quality entry, the agent has funded its next 3 tool calls for free.

print(agent.run("""
1. Search for current DeFi yields on Base chain.
2. Write a Hive entry summarizing the top 3 opportunities with domain_tags=['defi','base','yield'].
3. Report what you found.
"""))