BridgeNode Python SDK — AI inference for AI agents, no API keys. Pay per request with Solana USDC via x402. The payment handshake is fully automatic, and fees are sponsored — the agent needs no SOL.
- Start free, no wallet — free models run without payment, and the first 2 calls to a paid model are free per client (free trials); a wallet is needed only after that
- No API keys, no registration — pay per request with USDC
- Automatic x402 handshake — 402 → signed transaction → 200, fully hidden
- Fee sponsorship (gasless) — the agent needs zero SOL
- Fail-closed spending policy — per-call and daily caps checked before signing
- Receipt verification — every response receipt is verified (invalid → error)
- Smart routing —
mode: auto / eco / premium(model selection per prompt complexity) - MCP support — BridgeNode is also available as an MCP server
| BridgeNode | Traditional AI APIs | |
|---|---|---|
| Sign-up | None | Account + verification |
| API key | Not needed | Required (leak risk) |
| Billing | Pay-per-request (USDC) | Subscription / prepaid credits |
| Setup | Wallet only | SDK + key + quotas |
| Fees | Gas sponsored | Network fees on you |
| Spending control | Fail-closed caps | Account-level limits |
| Identity | Wallet signature (SIWX) | API key |
pip install bridgenode-llmOr install the full toolkit (SDK + CLI):
pip install bridgenodefrom bridgenode_llm import LLMClient
client = LLMClient() # wallet key from .env (BRIDGENODE_WALLET_KEY) — optional
resp = client.chat("deepseek-flash", [
{"role": "user", "content": "Hello!"}])
print(resp["choices"][0]["message"]["content"])Everything is handled automatically: payment, retry, receipt verification. No API key required.
Free models ("free": true in GET /v1/models) run without payment, and a
client that has never called BridgeNode gets 2 free calls on PAID models
(free trials) — real inference before any wallet exists. BRIDGENODE_WALLET_KEY
is read lazily: it is required only when a request actually reaches the payment
wall, and then the SDK raises one actionable error instead of a broken
handshake. The remaining trial count is exposed after every call:
client = LLMClient() # no wallet required for the free path
resp = client.chat("gpt-oss-120b", [{"role": "user", "content": "hi"}])
print(client.last_trials_remaining) # None for free models, 1 → 0 for trials# Let BridgeNode pick the model: auto / eco / premium
resp = client.chat(None, "Explain quantum computing", mode="auto")# Optional — your Solana wallet private key (base58).
# Needed only for PAID requests: free models and the 2 free trials work without it.
BRIDGENODE_WALLET_KEY=...
# Optional
# BRIDGENODE_BASE_URL=https://bridgenode.cc/v1
# BRIDGENODE_MAX_PER_CALL=0.05 # spending policy: max USD per call (fail-closed)
# BRIDGENODE_DAILY_CAP=1.0 # spending policy: max USD per day- Receipt verification: after each response, the payment receipt is verified (success, network, payer, signature over your transaction, amount). Invalid receipt →
BridgenodeError. - Spending policy (fail-closed):
BRIDGENODE_MAX_PER_CALL+BRIDGENODE_DAILY_CAPare checked BEFORE signing; exceeded → blocked, no payment. - SIWX: automatic known-agent identification — falls back to payment if auth fails.
- Python ≥ 3.11
- A Solana wallet with a USDC token account (ATA) — only for PAID requests; the free path (free models + free trials) needs no wallet
Do agents need SOL? No — fees are sponsored. The agent pays only the USDC request amount.
Is there an API key? No. Your wallet signature is the identity (SIWX); payment is the access.
Can an agent try it without a wallet? Yes — free models and the first 2 calls to a paid model per client are free, over HTTP, MCP and both SDKs.
What happens if the spending cap is exceeded? The request is blocked before signing — fail-closed, no payment is made.
Which models are available? See https://bridgenode.cc/v1/models (live list with prices).
How is the payment receipt verified? Every response includes a receipt; the SDK verifies its signature, network, payer and amount — invalid receipts raise BridgenodeError.
Can I use this in CI / headless agents? Yes — no browser, no keys, just a wallet private key in env.
The BridgeNode toolkit on PyPI:
bridgenode-llm— Python SDK (this package): https://pypi.org/project/bridgenode-llmbridgenode-cli— command-line interface: https://pypi.org/project/bridgenode-clibridgenode— full toolkit (SDK + CLI): https://pypi.org/project/bridgenodebridgenode-sdk— SDK alias package: https://pypi.org/project/bridgenode-sdkbridgenode-mcp— MCP server package: https://pypi.org/project/bridgenode-mcpbridgenode-skill— agent skill package: https://pypi.org/project/bridgenode-skill
- Website: https://bridgenode.cc
- Models & prices: https://bridgenode.cc/v1/models
- Documentation: https://bridgenode.cc/llms.txt
- Protocol: x402 V2 (https://docs.x402.org)
- Moltbook agent profile: https://moltbook.com/u/bridgenode_eli
- Discord: https://discord.gg/HUpVKxJxhG
- X (Twitter): https://x.com/eliBNx
⭐ Star this repo — it helps AI agents discover BridgeNode.