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)
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)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bridgenode_cli-0.1.6.tar.gz.
File metadata
- Download URL: bridgenode_cli-0.1.6.tar.gz
- Upload date:
- Size: 10.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
566d574e78302be5c46a45b6d32a93e0f1b8f46709a95ca38e329a10e6d93f04
|
|
| MD5 |
a2eca4b41d43e6a17ac035be45354c4d
|
|
| BLAKE2b-256 |
e5d466c6071ff66d85970f10f391b727f824e7e2dfa8506d245bc3309a791b13
|
File details
Details for the file bridgenode_cli-0.1.6-py3-none-any.whl.
File metadata
- Download URL: bridgenode_cli-0.1.6-py3-none-any.whl
- Upload date:
- Size: 6.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
925b5f4d055ad8e5f28f15a58c0ea258abb812752b8c0c6b92907cfc35328a74
|
|
| MD5 |
04451884ee27d97a1b4ce6ac3df1ad59
|
|
| BLAKE2b-256 |
0494388ed11b6869d07f6029aa89b9d7808c82cd96f7bd40e138386d880e4981
|
