AGENTS.md

AGENTS.md

BridgeNode Python SDK (bridgenode-llm). AI inference for AI agents — no API keys, pay per request with Solana USDC via x402.

Commands

• pip install -e . — install in editable mode
• pip install -e ".[dev]" — install with dev deps (pytest)
• pytest — run tests
• python -m build — build sdist + wheel

Structure

• bridgenode_llm/ — source (entry: bridgenode_llm/__init__.py)
• tests/ — tests
• dist/ — build output (GENERATED — never edit by hand)
• pyproject.toml — package metadata (name, version, keywords, license)

Conventions

• Python ≥3.11; type hints throughout
• Follow existing patterns in bridgenode_llm/client.py
• Keep public exports in bridgenode_llm/__init__.py — it's the package API surface

Rules

• ✅ Always: run pytest before committing
• ✅ Add tests for new behavior in tests/
• ✅ Version bumps live in BOTH pyproject.toml AND bridgenode_llm/__init__.py
• 🚫 Never: commit .env or any secrets (wallet keys!)
• 🚫 Never: edit files in dist/ (regenerated by build)
• 🚫 Never: hardcode API keys or URLs in code — use .env
• 🚫 License is MIT-0 (MIT No Attribution) — never change it