bridgenode-cli

BridgeNode CLI — 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 — no SOL needed.

Installation

pip install bridgenode-cli

Or install the full toolkit (SDK + CLI):

pip install bridgenode

Usage

# Single chat completion (payment handshake fully automatic)
bridgenode chat "Hello!" --model deepseek-v4-flash

# Smart routing: auto / eco / premium
bridgenode chat "Analyze this code" --mode auto

# Model list + prices (no payment)
bridgenode models

Options

Option	Description
`--model`	Explicit model id (see `bridgenode models`)
`--mode`	`auto` / `eco` / `premium` (smart routing)
`--max-tokens`	Max output tokens (billed upfront)
`--base-url`	Base URL (default: `BRIDGENODE_BASE_URL` / https://bridgenode.cc/v1)
`--max-per-call` / `--daily-cap`	Spending policy (fail-closed)

Configuration (.env)

# Required — your Solana wallet private key (base58)
BRIDGENODE_WALLET_KEY=...
# Optional: BRIDGENODE_BASE_URL, BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP

Security

Receipt verification: every response receipt is verified — invalid receipt → error.
Spending policy (fail-closed): max USD per call / per day — checked BEFORE signing.

Why BridgeNode (vs API keys)

	BridgeNode CLI	Traditional AI APIs
Sign-up	None	Account + verification
API key	Not needed	Required
Billing	Pay-per-request (USDC)	Subscription / credits
Fees	Gas sponsored	On you
Spending caps	Fail-closed per call/day	Account-level

FAQ

Do I need SOL? No — fees are sponsored; only the USDC request amount is paid.

Is there an API key? No — your wallet signature (SIWX) is the identity.

Can I cap spending? Yes — --max-per-call / --daily-cap (fail-closed, checked before signing).

Which models? See bridgenode models or https://bridgenode.cc/v1/models.

Requirements

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

Download files

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

Source Distribution

bridgenode_cli-0.1.9.tar.gz (10.5 kB view details)

Uploaded Aug 20, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

bridgenode_cli-0.1.9-py3-none-any.whl (6.8 kB view details)

Uploaded Aug 20, 2026 Python 3

File details

Details for the file bridgenode_cli-0.1.9.tar.gz.

File metadata

Download URL: bridgenode_cli-0.1.9.tar.gz
Upload date: Aug 20, 2026
Size: 10.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bridgenode_cli-0.1.9.tar.gz
Algorithm	Hash digest
SHA256	`0c0b6e959d5cac73cf0a3af2dba2604766bada948bc048d06df3fd7b1ed56aa6`
MD5	`cd8879b15122dc4ad2625d37c21605ec`
BLAKE2b-256	`7a5b1219a87c75367cdf9db1f4455250ffb78d3f823c7a7fae78552854af90f3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for bridgenode_cli-0.1.9.tar.gz:

Publisher: publish.yml on applefanaimail-blip/bridgenode-llm

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: bridgenode_cli-0.1.9.tar.gz
- Subject digest: 0c0b6e959d5cac73cf0a3af2dba2604766bada948bc048d06df3fd7b1ed56aa6
- Sigstore transparency entry: 2534104996
- Sigstore integration time: Aug 20, 2026
Source repository:
- Permalink: applefanaimail-blip/bridgenode-llm@a7595ad7676468bbeb3c481a020211c60123c686
- Branch / Tag: refs/tags/v1.0.2
- Owner: https://github.com/applefanaimail-blip
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@a7595ad7676468bbeb3c481a020211c60123c686
- Trigger Event: push