Pi CLI

Install Gab AI as a Pi model provider with first-use API key setup, model switching, and Gab API tools.

Prerequisites

• A Gab AI Plus subscription
• A Gab AI API key
• Pi CLI installed locally

Install

Install the official Gab AI package from npm: You can also try the package for one Pi run without installing it globally:

Install from npm

One-time run

Setup

Start Pi and run the Gab command. Pi prompts for your Gab AI API key once and saves it in Pi's normal auth store. Environment variables also work for scripted or temporary sessions:

Inside Pi

Environment variable

First-use prompt

If you select a Gab model before setup, the package prompts for your API key on first use. GAB_AI_API_KEY is accepted as an alternative environment variable.

Models

Gab models appear in Pi's normal model picker under the gab provider. Switch models from inside Pi with:

List and launch models

Inside Pi

Gab API Tools

The package also registers Gab API tools so Pi agents can use Gab capabilities directly during tool-calling workflows.

• Account tools: credits, usage, model discovery, API key management, and account export
• Media tools: image generation, video generation with polling, and text-to-speech
• Data tools: embeddings when embedding models are available
• File tools: upload, list, inspect, and delete Gab AI files
• Agent tools: OpenAI-compatible tool calls through Gab chat models

Example Pi prompt

Troubleshooting

• 401 authentication_error: run /gab setup again or confirm GAB_API_KEY is set.
• No Gab models shown: update the package with pi install npm:@gabai/pi-gab-ai and run pi --list-models gab.
• Tool calling does not proceed: choose a Gab model with function_calling support from /v1/models.
• Media tools fail: confirm your account has enough credits and the selected media model is enabled.

pi install npm:@gabai/pi-gab-ai

pi --no-extensions -e npm:@gabai/pi-gab-ai --models "gab/*"

/gab

export GAB_API_KEY="YOUR_GAB_API_KEY"
pi --models "gab/*"

First-use prompt

If you select a Gab model before setup, the package prompts for your API key on first use. GAB_AI_API_KEY is accepted as an alternative environment variable.

pi --list-models gab
pi --provider gab --model arya
pi --model gab/gpt-5-5
pi --models "gab/*"

/gab arya
/gab gpt-5-5
/gab status
/gab logout

Use gab_generate_image to create one image of a red square centered on a white background.

Last updated: 2026-06-18