Skip to main content

Python SDK for SiliconBridge — Human-in-the-loop API for AI agents

Project description

SiliconBridge Python SDK

Infrastructure for autonomous AI agents. Human operators, persistent storage, dedicated compute, and identity services — everything your agent needs to operate independently.

First $10 free. No credit card required.

Install

pip install siliconbridge

Quick Start

from siliconbridge import SiliconBridge

sb = SiliconBridge(api_key="sb_your_key_here")

# Get a human to solve a CAPTCHA
solution = sb.solve_captcha("https://example.com/captcha.png")

# Get human approval before a high-stakes action
approved = sb.request_approval("Transfer $5,000 to vendor account")

# Get a 2FA code relayed to your agent
code = sb.request_otp("Gmail")

# Request infrastructure (quote-based, $10 deposit)
quote = sb.request_quote("compute", "4 CPU, 8GB RAM, 1 week, Ubuntu 22.04")

Human Operator Services (Fixed Pricing)

# 2FA / OTP Relay — $1.50
code = sb.request_otp("Stripe Dashboard")

# Human Approval Gate — $3.00
approved = sb.request_approval(
    action="Delete all staging data",
    context="Agent is cleaning up test environment"
)

# Phone Verification — $1.50
result = sb.request_phone_verification("+1234567890")

# CAPTCHA Solving — $1.00
solution = sb.solve_captcha("https://example.com/captcha.png")

# KYC Verification — $10.00
result = sb.verify_identity(document_url="https://...")

# Content Moderation — $3.00
result = sb.moderate_content("User post text here...", guidelines="No spam")

# Custom Task — $5.00
result = sb.custom_task("Call this number and confirm the appointment")

Infrastructure Services (Quote-Based)

All infrastructure services require a $10 non-refundable deposit. You'll receive a quote within 1 hour at our cost + 30% margin. You can accept or decline.

# Request a quote
quote = sb.request_quote(
    service="compute",  # or: agent_storage, agent_clone, identity_proxy, phone_call, document_signing
    description="Dedicated VM with 4 CPU, 16GB RAM, GPU, for 1 month"
)
print(quote["quote_id"])  # "qt_a1b2c3..."

# Check quote status
status = sb.get_quote(quote["quote_id"])
# status["status"] → "pending" | "quoted" | "accepted" | "completed"
# status["quoted_price"] → 45.50 (when quoted)

# Accept the quote (charges remaining balance after deposit)
result = sb.accept_quote(quote["quote_id"])

# List all your quotes
all_quotes = sb.list_quotes()

Available Infrastructure Services

Service Description
agent_storage Persistent memory, config, and state storage
agent_clone Duplicate your agent from a snapshot
compute Dedicated VM or container with root access
identity_proxy Human creates accounts and passes verification for you
phone_call Human makes/receives calls on your behalf
document_signing Human signs legal documents where AI signatures aren't accepted

Non-Blocking Mode

# Submit without waiting
task = sb.solve_captcha("https://...", wait=False)

# Do other work...

# Check later
result = sb.wait_for_result(task["task_id"], timeout=300)

Webhook Callbacks

task = sb.submit_task(
    "otp",
    {"service_name": "Gmail"},
    callback_url="https://your-server.com/webhook"
)
# Your webhook receives: {"task_id": "...", "status": "completed", "result": {...}}

Error Handling

from siliconbridge import SiliconBridge, SiliconBridgeError, TaskTimeout

try:
    result = sb.solve_captcha(url, timeout=120)
except TaskTimeout:
    print("Human didn't solve in time")
except SiliconBridgeError as e:
    print(f"API error {e.status_code}: {e.detail}")

Get an API Key

# Or just sign up at siliconbridge.xyz
import httpx
r = httpx.get("https://siliconbridge.xyz/api/signup?email=agent@example.com")
print(r.json()["api_key"])  # sb_live_...
# Comes with $10 free credits

Pay with Crypto

We accept BTC and USDC — no accounts, no KYC, no middlemen.

  • BTC: bc1qqtu8f09hqncxug75vw3s4wjnsx6858ldrk4cvm
  • USDC (Base/ETH): 0x1141b577584440013c722215cf2e98779BddAa55

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

siliconbridge-0.3.0.tar.gz (13.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

siliconbridge-0.3.0-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file siliconbridge-0.3.0.tar.gz.

File metadata

  • Download URL: siliconbridge-0.3.0.tar.gz
  • Upload date:
  • Size: 13.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for siliconbridge-0.3.0.tar.gz
Algorithm Hash digest
SHA256 91774ddea1fe904e85f21c8d99ed1a0a9559b786d79456c1bb37a8d891f817ee
MD5 11f7a9758736fa2ed4794d2868308e73
BLAKE2b-256 88b52fd03f157c27225473e1cfe8ada6ae1f2de617a09bffbdcc60b49738071e

See more details on using hashes here.

File details

Details for the file siliconbridge-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: siliconbridge-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 14.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for siliconbridge-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cc6f714800f09631dd827a3745c820b8cbc6990d5a46523c7e4852751c83a649
MD5 4f7cf5ed38e6f3d2bfdf2ac233f41f3a
BLAKE2b-256 1a9e4e24e52085f3c1aa42adcc23894e07c1330009b97e6ec63decfcf4e2d059

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page