Skip to main content
This page explains how to run models from Modular Cloud on Pi.

Before you begin

Make sure you have:

Configure a Pi provider

To register Modular Cloud as a provider in Pi:
  1. Open (or create) the ~/.pi/agent/models.json configuration file.
  2. Choose the model that you want from our list of shared endpoints or use a dedicated deployment if applicable.
  3. Add Modular Cloud as a provider:
    models.json
    Modular Cloud supports the OpenAI chat completions API, so set api to openai-completions. Modular Cloud doesn’t support the OpenAI responses API.
Once you save your models.json file, run /model in Pi and select the Modular Cloud model to use.
The example above demonstrates a basic provider and model configuration. To see the complete list of configuration options, see the Pi documentation on Custom Models.