pi-agnes

Pi extension for Agnes AI, with dynamic model discovery and support for both Agnes endpoints.

Install

pi install npm:pi-agnes

Or install from git:

pi install git:github.com/pgciq/pi-agnes

Configuration

Set the API key for the endpoint you want to use:

Provider	Endpoint	Environment variable
agnes	https://apihub.agnes-ai.com/v1	AGNES_API_KEY
agnes-cn	https://api.agnes-ai.cn/v1	AGNES_CN_API_KEY

Model discovery (non-blocking)

pi-agnes registers a seed model catalog synchronously at load (so pi starts instantly) and refreshes it from /v1/models in the background via pi's refreshModels callback — it never blocks startup on the network.

• The seed list is always available immediately, even offline or without AGNES_API_KEY / AGNES_CN_API_KEY.
• A successful background refresh replaces the seed list and is persisted to pi's provider cache, so it survives restarts and offline starts.
• Every network call is bounded by a timeout and degrades to the seed list on any failure.

Image generation

Both Agnes endpoints expose POST /v1/images/generations; the main and CN endpoints were live-tested with agnes-image-2.1-flash. Generated images are saved under .pi/generated-images/; supported terminals receive a TUI Image entry (rendered inline when the terminal supports a graphics protocol), and the saved path is reported as a clickable file:// link in the TUI. Print/RPC mode reports the saved path as plain text.

Usage

pi --model agnes/agnes-2.5-flash "你好"
pi --model agnes-cn/agnes-2.5-pro "你好"