Metadata-Version: 2.5
Name: neuforge-phidata
Version: 1.0.1
Summary: NeuForge x402 Token Metering for Phidata Agents
Project-URL: Homepage, https://github.com/sophieamoure2026-ui/neuforge-phidata
Requires-Python: >=3.10
Requires-Dist: phidata>=2.0.0
Description-Content-Type: text/markdown

# NeuForge Pay for Phidata (`neuforge-phidata`)

NeuForge Token Metering Wrapper for Phidata Agents to enforce Bounded Overshoot natively.

> **⚠️ Pricing & Metering Disclosure**
> This SDK requires an active API key from [neuforge.app](https://neuforge.app). 
> You can sign up to start a **3-day free trial**.
> It acts as a cloud-metered gateway that tracks your LLM token usage and synchronizes it synchronously with the NeuForge backend via HTTP. 
> 
> **Important:** If your NeuForge account balance drops below zero or your budget is exceeded, this SDK will intentionally halt your execution by throwing an `HTTP 402 Payment Required` exception. You must manage your billing on neuforge.app to ensure uninterrupted service.

## Usage

```python
from neuforge_phidata import SecureAgent

# Use SecureAgent instead of Agent, powered by your NeuForge API Key
agent = SecureAgent(
    api_key="nf_live_your_api_key_here",
    instructions=["You are a helpful assistant."]
)

# Runs are metered and halt on budget exhaustion
agent.print_response("Tell me a story.")
```
