omp packages

pi-agnes1.0.9

Pi extension for Agnes AI providers

GitHub Actions Published 1 month ago MIT ~673 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

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

You can store either key in Pi instead of an environment variable:

/login agnes
/login agnes-cn

Pi saves credentials in ~/.pi/agent/auth.json; the environment variables remain supported as fallbacks.

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, and print/RPC mode reports the saved path.

Usage

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