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.2.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.2.0-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: siliconbridge-0.2.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.2.0.tar.gz
Algorithm Hash digest
SHA256 1e0e55cdca6f0aeddb61ccf01bc07158cf2a186e9bbe49b30b4cfe8fb3e659f9
MD5 70ea468e637bf2f7dc35d144d9142c24
BLAKE2b-256 78e7bca32d54387db8b1c2b2ae65001923acf45ef86961352047f904ed5ed8ea

See more details on using hashes here.

File details

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

File metadata

  • Download URL: siliconbridge-0.2.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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b2dc9b0cc7676e217051ec91ac5a76ffe362729602d2982bd4524dbfae976756
MD5 e0e1c6e1a1d7f5021bb151726c3aa259
BLAKE2b-256 bf97f033ff752039320588bf45a5c7a93a72f367b64e8d3a62d3355c323ba5c2

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