Skip to main content

bridgenode

PyPI version Downloads License: MIT-0 Python versions CI

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-v4-flash", [
    {"role": "user", "content": "Hello!"}])
print(resp["choices"][0]["message"]["content"])

Quick start (CLI)

bridgenode chat "Hello!" --model deepseek-v4-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 routingmode: 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

Download files

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

Source Distribution

bridgenode-0.1.8.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

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

bridgenode-0.1.8-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file bridgenode-0.1.8.tar.gz.

File metadata

  • Download URL: bridgenode-0.1.8.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bridgenode-0.1.8.tar.gz
Algorithm Hash digest
SHA256 37c7a23826672a09f2fa8aa38040bd4a180bf5bfa93f1a825e3190c8d2439f3d
MD5 a277306a7e7a32f4e5a0ae73fe9817ef
BLAKE2b-256 a1af7844ed2c20f3f1913cc8036c8f2eb41bee29bbdcee5f60d10a9a61fb4a7f

See more details on using hashes here.

Provenance

The following attestation bundles were made for bridgenode-0.1.8.tar.gz:

Publisher: publish.yml on bridgenode-ai/bridgenode-llm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bridgenode-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: bridgenode-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bridgenode-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 b81f7fec7ddf2ed01e31c3f7b68871540d04829790072b0a00e9dc1f0ea45921
MD5 1a9ab8172e13949a3946ca30af9b717e
BLAKE2b-256 ca590a926f7edfada32b80b888311dd9992bd74c8e3601320abb0dd2e1b0ccd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for bridgenode-0.1.8-py3-none-any.whl:

Publisher: publish.yml on bridgenode-ai/bridgenode-llm

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page