@d3ara1n/pi-provider-agnes
Agnes AI provider for pi — registers agnes (token billing) and agnes-plan (subscription) providers with text models
Package details
Install @d3ara1n/pi-provider-agnes from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@d3ara1n/pi-provider-agnes- Package
@d3ara1n/pi-provider-agnes- Version
1.1.0- Published
- Jul 10, 2026
- Downloads
- 264/mo · 264/wk
- Author
- d3ara1n
- License
- MIT
- Types
- extension
- Size
- 5.2 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@d3ara1n/pi-provider-agnes
Agnes AI provider for pi — registers two providers sharing the same text models but differing in billing model.
Providers
| Provider ID | Name | Billing | API Key Env |
|---|---|---|---|
agnes |
Agnes AI | Token billing | $AGNES_API_KEY |
agnes-plan |
Agnes AI (Token Plan) | Subscription plan | $AGNES_PLAN_API_KEY |
agnes
Token-based billing provider. Agnes has not published official token pricing, so cost values are 0 (no cost shown). Update when Agnes publishes pricing — use the non-discounted regular-period price (see PROVIDER.md).
agnes-plan
Subscription plan provider. Cost set to zero — the subscription fee is a fixed monthly charge, not per-token.
Models
Both providers export the same text models:
| Model | Reasoning | Input | Context | Max Output |
|---|---|---|---|---|
agnes-2.0-flash |
Yes | text, image | 256K | 64K |
agnes-1.5-flash |
No | text, image | 256K | 64K |
Installation
pi install npm:@d3ara1n/pi-provider-agnes
Or add to ~/.pi/agent/settings.json:
{
"extensions": [
"/absolute/path/to/pi-extensions/packages/pi-provider-agnes"
]
}
Set your API key(s) via environment variable:
export AGNES_API_KEY="sk-..." # for agnes provider
export AGNES_PLAN_API_KEY="sk-..." # for agnes-plan provider
Or configure via /login or auth.json.
Dependencies
None — this is a standalone provider with no pi-extension dependencies. It uses pi's built-in openai-completions streaming.
Usage Quota Reporting
Not yet implemented. Agnes AI does not currently expose a public quota or balance API. When one becomes available, quota reporting will be added via @d3ara1n/pi-usage-block-core. See plans/pi-provider-agnes.md for the integration plan.