What is smolagents?
Hugging Face's lightweight framework for building AI agents. Minimal, code-first approach to agent development.
How It Works
Scavio connects to smolagents via a custom tool definition. Once connected, your smolagents agent can search Google, Amazon, YouTube, and Walmart in real time. Each search returns structured JSON — no HTML parsing, no scraping infrastructure.
Setup
Bash
pip install smolagents requestsCode Example
Here is a complete smolagents integration with Scavio:
Python
from smolagents import tool, CodeAgent, HfApiModel
import requests
import json
@tool
def scavio_search(query: str) -> str:
"""Search the web for real-time results using Scavio API."""
response = requests.post(
"https://api.scavio.dev/api/v1/search",
headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
json={"query": query},
)
return json.dumps(response.json())
agent = CodeAgent(tools=[scavio_search], model=HfApiModel())
result = agent.run("Find the best noise cancelling headphones")
print(result)Full Working Example
A production-ready example with error handling:
Python
from smolagents import tool, CodeAgent, HfApiModel
import requests
import json
@tool
def scavio_search(query: str) -> str:
"""Search the web for real-time results using Scavio API."""
response = requests.post(
"https://api.scavio.dev/api/v1/search",
headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
json={"query": query},
)
return json.dumps(response.json())
agent = CodeAgent(tools=[scavio_search], model=HfApiModel())
result = agent.run("Find the best noise cancelling headphones")
print(result)Available Platforms
Once connected, your smolagents agent has access to all four Scavio platforms:
- Google — Web search with knowledge graph, PAA, and AI overviews
- Amazon — Product search with prices, ratings, and reviews
- Reddit — Community, posts & threaded comments from any subreddit
- YouTube — Video search with transcripts and metadata
- Walmart — Product search with pricing and fulfillment data
Pricing
Scavio offers a free tier with 500 credits/month (1 credit per search). No credit card required. This is enough to build and test your smolagents integration. Paid plans start at $30/month for higher volumes.