Skip to main content
VOID

Toolsgoose

goose

Add Void API as a reusable custom provider in goose CLI or Desktop.

block.github.io/gooseOfficial setup docs

MODEL_ID is a placeholder. Choose a model from the catalog that supports this tool's endpoint and features.

  1. API key

    Store your key in an environment variable.

    export VOID_API_KEY='void_your_key'

    Run in Bash or Zsh. Sets the values for this terminal only. To keep them for future sessions, also add these commands to ~/.bashrc or ~/.zshrc.

  2. Configuration

    Create a custom OpenAI-compatible provider. goose expects the complete chat completions URL.

    ~/.config/goose/custom_providers/void_api.json
    {
      "name": "void_api",
      "engine": "openai",
      "display_name": "Void API",
      "description": "Void API OpenAI-compatible provider",
      "api_key_env": "VOID_API_KEY",
      "base_url": "https://void-api.tech/v1/chat/completions",
      "models": [
        {
          "name": "MODEL_ID"
        }
      ],
      "supports_streaming": true,
      "requires_auth": true
    }
  3. Run

    Start a session with the custom provider.

    shell
    goose session start --provider void_api

Create a key in your account; model IDs are in the catalog.