How to use Openaq with smolagents
Integrate Openaq into your smolagents agent with SettleGrid's per-call billing. No subscriptions, no minimums — pay only for what you use.
About Openaq
Global air quality measurements from thousands of monitoring stations.
About smolagents
smolagents is Hugging Face's lightweight framework for building AI agents with minimal boilerplate. It emphasizes simplicity and tool composition.
Integration Guide
Install smolagents
pip install smolagentsGet your SettleGrid API key
Purchase credits for Openaq, then generate an API key from your Consumer Dashboard.
Register Openaq in your smolagents agent
from smolagents import Tool, CodeAgent, HfApiModel
import requests
class OpenaqTool(Tool):
name = "openaq"
description = "Openaq — call via SettleGrid"
inputs = {"query": {"type": "string", "description": "Input query"}}
output_type = "string"
def forward(self, query: str) -> str:
resp = requests.post(
"https://proxy.settlegrid.ai/v1/openaq",
headers={
"x-api-key": "sg_live_your_key_here",
"Content-Type": "application/json",
},
json={"query": query},
)
resp.raise_for_status()
return str(resp.json())
# Create agent with the tool
model = HfApiModel()
agent = CodeAgent(tools=[OpenaqTool()], model=model)
result = agent.run("Use Openaq to process this input")Run your agent
Execute your smolagents agent. SettleGrid automatically meters each call to Openaq and deducts from your credit balance. No rate limits beyond your purchased credits.
Pricing
No subscriptions or minimums. Credits never expire. See full pricing details.
Other Frameworks
Use Openaq with other agent frameworks: