Metadata-Version: 2.4
Name: bridgenode-cli
Version: 0.1.1
Summary: BridgeNode CLI — AI inference with x402 payment on Solana USDC. No API keys.
Author-email: BridgeNode <eli.BNx@proton.me>
License-Expression: MIT
Project-URL: Homepage, https://bridgenode.cc
Project-URL: Repository, https://github.com/applefanaimail-blip/bridgenode-llm
Project-URL: Documentation, https://bridgenode.cc/llms.txt
Keywords: x402,solana,usdc,ai,llm,cli,agents,payment,bridgenode
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: bridgenode-llm>=0.1.0
Provides-Extra: dev
Requires-Dist: pytest>=9.1.1; extra == "dev"

# bridgenode-cli

BridgeNode CLI — AI inference without API keys. Payment: **Solana USDC via x402** (automatic handshake, fee sponsorship — no SOL needed).

## Installation

```bash
pip install bridgenode-cli
```

## Usage

```bash
# Single chat completion (x402 handshake hidden, §4.1)
bridgenode chat "Hello!" --model deepseek-v4-flash

# Smart routing (§5.1/§5.8): auto / eco / premium
bridgenode chat "Analyze this code" --mode auto

# Model list + prices (§5.2) — 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 (billing upfront, §4.2) |
| `--base-url` | Base URL (default: `BRIDGENODE_BASE_URL` / https://bridgenode.cc/v1) |
| `--max-per-call` / `--daily-cap` | Spending policy (fail-closed) |

## .env

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

## Security

- **Receipt verification (Free-Riding protection):** after 200, `PAYMENT-RESPONSE` is verified — invalid receipt → error.
- **Spending policy (fail-closed):** max USD per call / per day — checked BEFORE signing.

## Requirements

- Python ≥ 3.11
- Solana wallet with USDC ATA (rent — agent's responsibility, §3.3)

## Links

- Website: https://bridgenode.cc
- Protocol: x402 V2 (docs.x402.org)
