LangChain (Python)

pip install langchain-oneshot

from langchain_oneshot import OneShotToolkit
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

toolkit = OneShotToolkit.from_private_key(
    private_key="0x...",
)

# Every tool, ready to go
tools = toolkit.get_tools()

# Wire into any LangChain-compatible agent
llm = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(llm, tools)

result = agent.invoke({
    "messages": [("user", "Research the latest AI agent frameworks")]
})

from langchain_oneshot import OneShotClient, ResearchTool

client = OneShotClient(private_key="0x...")
research = ResearchTool(client=client)
result = research.invoke({"topic": "AI agent frameworks 2026"})

toolkit = OneShotToolkit.from_private_key("0x...")

# Debug logging
toolkit = OneShotToolkit.from_private_key("0x...", debug=True)

# Credits-only session for code that must not hold a wallet key (see Remote MCP):
toolkit = OneShotToolkit.from_access_token("oneshot_...")
# Inside a running event loop use the async factory instead:
toolkit = await OneShotToolkit.afrom_access_token("oneshot_...")

from langchain_oneshot import OneShotClient, EmailTool

client = OneShotClient(private_key="0x...")
email = EmailTool(client=client)

result = email.invoke({
    "to": "[email protected]",
    "subject": "Meeting Tomorrow",
    "body": "Hi John, let's meet at 3pm instead. Thanks!"
})

from langchain_oneshot import OneShotClient, ResearchTool

client = OneShotClient(private_key="0x...")
research = ResearchTool(client=client)

result = research.invoke({
    "topic": "State of AI agent frameworks in 2026",
    "depth": "deep"
})

from langchain_oneshot import OneShotClient, PersonEmailTool, PersonEmailStatusTool

client = OneShotClient(private_key="0x...")

# Find someone's email
finder = PersonEmailTool(client=client)
found = finder.invoke({
    "full_name": "Jane Smith",
    "company_domain": "acme.com"
})

# Verify it's deliverable
verifier = PersonEmailStatusTool(client=client)
verified = verifier.invoke({"email": "[email protected]"})

from langchain_oneshot import OneShotClient, BuildTool

client = OneShotClient(private_key="0x...")
build = BuildTool(client=client)

result = build.invoke({
    "product": {
        "name": "Acme Analytics",
        "description": "Real-time analytics dashboard for modern teams"
    },
    "type": "saas",
    "lead_capture": {"enabled": True}
})

import json
import time

from langchain_oneshot import OneShotClient, BrowserTool, BrowserCreateProfileTool

client = OneShotClient(private_key="0x...")

# Create a profile. Like every langchain-oneshot tool, invoke() returns the API
# response as a JSON string, so parse it before reading fields.
create = BrowserCreateProfileTool(client=client)
profile = json.loads(create.invoke({"name": "my-scraper"}))

# Complete account login/2FA through the core SDK before invoking BrowserTool.
setup = client.start_browser_profile_setup(profile["id"], "https://github.com/login")
# setup["setup_url"] is the link to the OneShot sign-in page. Give it only to the person
# whose account it is, and never open it yourself. Treat it as a secret: it opens once and
# expires after 10 minutes; client.create_browser_profile_setup_link(profile["id"])
# (oneshot-python 0.41.0+) mints a fresh one. The page is not cached and sends no referrer.
# They sign in, then press Done on the page (Cancel ends the setup without marking it complete).
# live_url is deprecated and removed in the next release.

# Poll until the person pressed Done ("completed_at" set). After Cancel or the 15-minute
# expiry the status is "no_setup" or "expired" and "completed_at" stays None, so stop there.
status = client.get_browser_profile_setup(profile["id"])
while not status.get("completed_at"):
    if status.get("status") in ("expired", "no_setup", "stopped"):
        raise RuntimeError("Account setup ended before Done was pressed")
    time.sleep(5)
    status = client.get_browser_profile_setup(profile["id"])

# Reuse the authenticated profile
browser = BrowserTool(client=client)
result = browser.invoke({
    "task": "Go to github.com/notifications and list unread items",
    "profile_id": profile["id"],
    "allowed_domains": ["github.com"],
})

from langchain_oneshot import (
    OneShotClient,
    EmailTool,
    ResearchTool,
    InboxListTool,
)
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

client = OneShotClient(private_key="0x...")

# Pick only the tools you need
tools = [
    ResearchTool(client=client),
    EmailTool(client=client),
    InboxListTool(client=client),
]

agent = create_react_agent(ChatOpenAI(model="gpt-4o"), tools)
result = agent.invoke({
    "messages": [("user", "Research quantum computing breakthroughs and email a summary to [email protected]")]
})