Zuplo
Integrations

goose

goose is a local AI agent and CLI tool for automating engineering tasks. It's completely open-source with no vendor lock-in, supports local LLMs, has extensive MCP (Model Context Protocol) support, and offers powerful extensibility through recipes.

Prerequisites

Create a provider in the AI Gateway for the provider you want to use with goose, then get a gateway URL and key in one of two ways:

  • Use your personal API key (recommended). goose runs on your own machine, so call the project's User App. Open the My Keys tab of your AI Gateway project, copy the Gateway URL, and create a key under My API keys. Your requests count against your own budget.
  • Use an app. For a shared or automated setup, create a pool and an app for goose, then copy the app's API URL and API Key.

The rest of this guide calls these your gateway URL and gateway key.

Configure goose

Because goose can be run as a standalone desktop app and a CLI there are two configuration approaches depending on which version you choose.

CLI

  1. Run goose configure

  2. Select Configure Providers from the menu

  3. Choose OpenAI as the provider you want to add (this will work for any OpenAI compatible provider and model)

  4. Set the OPENAI_API_KEY to your gateway key

  5. Set the OPENAI_HOST to your gateway URL without the /v1 suffix (for example https://my-gateway-main-2e18f50.zuplo.app/u/741d375d631b429293481d6d0458bb64)—the base path in the next step supplies it

  6. The OPENAI_BASE_PATH may already be configured. If it's not, enter v1/chat/completions as the value

  7. Enter the model you want to use with goose, as providerName/model—for example openai/gpt-6-luna.

The Model Filtering policy on the User App or the app controls which models you may use, so the model you enter here must be one that policy allows.

After completing the steps, goose will check the configuration. If all is well it will save the configuration and you are ready to start working with goose via the AI Gateway.

Desktop App

If you are using the goose desktop app you can add a Custom Provider for AI Gateway by following these steps:

  1. Open the goose desktop app

  2. Click on Settings

  3. Click on Configure Providers to open the Provider settings

  4. Click on Add Custom Provider

  5. Choose a Provider Type (both OpenAI Compatible and Anthropic compatible will work)

  6. Enter a Display Name (for example Zuplo AI Gateway)

  7. Set the API URL to your gateway URL

  8. Set the API Key to your gateway key

  9. Set the list of Available Models to the models the Model Filtering policy allows, named as providerName/model (for example openai/gpt-6-luna and openai/gpt-6.1-sol)

  10. Click on Create Provider

The Zuplo AI Gateway and associated provider and models will now be available to use with the goose desktop app.

Last modified on
GitHub CopilotLangChain SDK