bridgenode

BridgeNode — AI inference for AI agents, no API keys. Pay per request with Solana USDC via x402. No API keys, no registration — the payment handshake is fully automatic, and fees are sponsored (the agent needs no SOL).

This is the full toolkit meta-package: it installs the Python SDK (bridgenode-llm) and the CLI (bridgenode-cli) in one step.

Installation

pip install bridgenode

This installs:

• bridgenode-llm — the Python SDK (LLMClient): from bridgenode_llm import LLMClient
• bridgenode-cli — the command-line tool: bridgenode chat "Hello!"

Quick start (Python)

from bridgenode_llm import LLMClient

client = LLMClient()  # key from .env (BRIDGENODE_WALLET_KEY)
resp = client.chat("deepseek-flash", [
    {"role": "user", "content": "Hello!"}])
print(resp["choices"][0]["message"]["content"])

Quick start (CLI)

bridgenode chat "Hello!" --model deepseek-flash
bridgenode models  # list models + prices (no payment)

Configuration (.env)

# Required — your Solana wallet private key (base58)
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

Features

• 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
• MCP support — BridgeNode is also available as an MCP server

Requirements

• Python ≥ 3.11
• A Solana wallet with a USDC token account (ATA)

Links

• Website: https://bridgenode.cc
• Models & prices: https://bridgenode.cc/v1/models
• Documentation: https://bridgenode.cc/llms.txt
• Protocol: x402 V2 (https://docs.x402.org)
• Full SDK docs & FAQ: https://pypi.org/project/bridgenode-llm