langchain-sidequest

Give your LangChain or LangGraph agent hands in the real world. SideQuest lets an agent hire a verified local person to check a store, photograph a shelf or property, inspect an item before purchase, run a pickup and drop-off, or make a phone call. Every quest is paid upfront into escrow, and the person submits photo, GPS, and written proof.

Install

pip install langchain-sidequest

Get an API key at sidequestpays.com/post (or POST /v1/requesters), then:

export SIDEQUEST_API_KEY=sq_live_...

Use

from langchain_sidequest import SideQuestToolkit
from langgraph.prebuilt import create_react_agent

tools = SideQuestToolkit().get_tools()
agent = create_react_agent("anthropic:claude-sonnet-4-5", tools)

agent.invoke({"messages": [("user", "Check if Joe's Hardware at 412 Main St, Philadelphia is open right now and photograph the hours sign. Budget $15.")]})

Tools: list_templates, create_quest, get_quest, list_quests, approve_quest, dispute_quest, cancel_quest, get_balance.

Use SideQuestToolkit(read_only=True) for an agent that should only look up quests.

Safety and spending

Create a capped agent key so an agent can't overspend: POST /v1/keys with max_quest_usd and daily_limit_usd, or require your approval by email for every quest with requires_approval: true. See the docs.

License

MIT