Metadata-Version: 2.4
Name: bridgenode-cli
Version: 0.1.0
Summary: BridgeNode CLI — AI inference su x402 mokėjimu (Solana USDC). Jokių API key.
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 be API key. Mokėjimas: **Solana USDC per x402** (automatinis handshake, fee sponsorship — SOL nereikia).

## Diegimas

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

## Naudojimas

```bash
# Vienas chat completion (x402 handshake paslėptas, §4.1)
bridgenode chat "Labas!" --model deepseek-v4-flash

# Smart routing (§5.1/§5.8): auto / eco / premium
bridgenode chat "Išanalizuok šį kodą" --mode auto

# Modelių sąrašas + kainos (§5.2) — be mokėjimo
bridgenode models
```

## Parinktys

| Parinktis | Aprašas |
|---|---|
| `--model` | Explicit model id (žr. `bridgenode models`) |
| `--mode` | `auto` / `eco` / `premium` (smart routing) |
| `--max-tokens` | Max output tokenų (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
# Privalomas — jūsų Solana wallet private key (base58)
BRIDGENODE_WALLET_KEY=...
# Neprivalomi: BRIDGENODE_BASE_URL, BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP
```

## Apsaugos

- **Kvito verifikacija (Free-Riding apsauga):** po 200 tikrinamas `PAYMENT-RESPONSE` — netikras kvitas → klaida.
- **Spending policy (fail-closed):** max USD per call / per day — tikrinama PRIEŠ pasirašant.

## Reikalavimai

- Python ≥ 3.11
- Solana wallet su USDC ATA (rent — agento atsakomybė, §3.3)

## Nuorodos

- Tinklalapis: https://bridgenode.cc
- Protokolas: x402 V2 (docs.x402.org)
