---
slug: "aliou-pi-poolside"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/aliou/pi-poolside@main/README.md"
repo: "https://github.com/aliou/pi-poolside"
source_file: "README.md"
branch: "main"
---
# @aliou/pi-poolside

Pi extension package for the [Poolside](https://poolside.ai) inference API.

Provides the `poolside` provider with OpenAI-compatible completions endpoint.
The extension registers cached models at startup and refreshes the model list
through Pi's provider refresh API when credentials are available.

## Models

| Model | Reasoning | Context | Max Output |
|-------|-----------|---------|------------|
| `poolside/laguna-m.1` | yes | 262144 | 32768 |
| `poolside/laguna-xs-2.1` | yes | 262144 | 32768 |

## Setup

1. Install the package:

   ```bash
   pi install npm:@aliou/pi-poolside
   ```

2. Configure your API key. Either:

   - Set the `POOLSIDE_API_KEY` environment variable
   - Add the key to `~/.pi/agent/auth.json`:
     ```json
     { "poolside": { "type": "api_key", "key": "your-api-key" } }
     ```
   - Add the key via `models.json` (see [Custom Models docs](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md) for full configuration reference):
     ```json
     {
       "providers": {
         "poolside": {
           "apiKey": "your-api-key"
         }
       }
     }
     ```

3. Select a poolside model in Pi.

## Auth resolution order

1. CLI `--api-key` flag
2. `auth.json` entry for `poolside`
3. Environment variable `POOLSIDE_API_KEY`

## Development

```bash
pnpm install
pnpm typecheck
pnpm lint
pnpm check:lockfile
```

## Layout

- `extensions/provider/`: Pi provider extension entry point and model refresh logic.