From 66e5c2a9a039c85d3c4fd047ccd408e8dd16f4a6 Mon Sep 17 00:00:00 2001 From: FuturMix Date: Wed, 13 May 2026 23:43:17 +0800 Subject: [PATCH] Add FuturMix provider (#8840) --- .../src/providers/declarative/futurmix.json | 36 +++++++++++++++++ .../docs/getting-started/providers.md | 40 +++++++++++++++++++ 2 files changed, 76 insertions(+) create mode 100644 crates/goose/src/providers/declarative/futurmix.json diff --git a/crates/goose/src/providers/declarative/futurmix.json b/crates/goose/src/providers/declarative/futurmix.json new file mode 100644 index 00000000..ab73c0b6 --- /dev/null +++ b/crates/goose/src/providers/declarative/futurmix.json @@ -0,0 +1,36 @@ +{ + "name": "futurmix", + "engine": "openai", + "display_name": "FuturMix", + "description": "Unified AI gateway with OpenAI-compatible API supporting models from Anthropic, Google, and OpenAI", + "api_key_env": "FUTURMIX_API_KEY", + "base_url": "https://futurmix.ai/v1/chat/completions", + "models": [ + { + "name": "claude-sonnet-4-20250514", + "context_limit": 200000, + "max_tokens": 16384 + }, + { + "name": "gpt-4o", + "context_limit": 128000, + "max_tokens": 16384 + }, + { + "name": "gemini-2.5-pro", + "context_limit": 1048576, + "max_tokens": 65536 + }, + { + "name": "deepseek-chat", + "context_limit": 131072, + "max_tokens": 8192 + }, + { + "name": "claude-haiku-4-20250514", + "context_limit": 200000, + "max_tokens": 16384 + } + ], + "supports_streaming": true +} diff --git a/documentation/docs/getting-started/providers.md b/documentation/docs/getting-started/providers.md index dfa0632c..8288e2b0 100644 --- a/documentation/docs/getting-started/providers.md +++ b/documentation/docs/getting-started/providers.md @@ -30,6 +30,7 @@ goose is compatible with a wide range of LLM providers, allowing you to choose a | [ChatGPT Codex](https://chatgpt.com/codex) | Access GPT-5 Codex models optimized for code generation and understanding. **Requires a ChatGPT Plus/Pro subscription.** | No manual key. Uses browser-based OAuth authentication for both CLI and Desktop. | | [Databricks](https://www.databricks.com/) | Unified data analytics and AI platform for building and deploying models. | `DATABRICKS_HOST`, `DATABRICKS_TOKEN` | | [Docker Model Runner](https://docs.docker.com/ai/model-runner/) | Local models running in Docker Desktop or Docker CE with OpenAI-compatible API endpoints. **Because this provider runs locally, you must first [download a model](#local-llms).** | `OPENAI_HOST`, `OPENAI_BASE_PATH` | +| [FuturMix](https://futurmix.ai/) | Unified AI gateway providing access to models from Anthropic, Google, OpenAI, and DeepSeek through an OpenAI-compatible API. | `FUTURMIX_API_KEY` | | [Gemini](https://ai.google.dev/gemini-api/docs) | Advanced LLMs by Google with multimodal capabilities (text, images). Gemini 3 models support configurable [thinking levels](#gemini-3-thinking-levels). | `GOOGLE_API_KEY`, `GEMINI3_THINKING_LEVEL` (optional) | | [GCP Vertex AI](https://cloud.google.com/vertex-ai) | Google Cloud's Vertex AI platform, supporting Gemini and Claude models. **Credentials must be [configured in advance](https://cloud.google.com/vertex-ai/docs/authentication).** Filters for allowed models by organization policy (if configured). | `GCP_PROJECT_ID`, `GCP_LOCATION` and optionally `GCP_MAX_RATE_LIMIT_RETRIES` (5), `GCP_MAX_OVERLOADED_RETRIES` (5), `GCP_INITIAL_RETRY_INTERVAL_MS` (5000), `GCP_BACKOFF_MULTIPLIER` (2.0), `GCP_MAX_RETRY_INTERVAL_MS` (320_000). | | [GitHub Copilot](https://docs.github.com/en/copilot/using-github-copilot/ai-models) | Access to AI models from OpenAI, Anthropic, Google, and other providers through GitHub's Copilot infrastructure. **GitHub account with Copilot access required.** | No manual key. Uses [device flow authentication](#github-copilot-authentication) for both CLI and Desktop. | @@ -694,6 +695,45 @@ To set up Groq with goose, follow these steps: +### FuturMix +[FuturMix](https://futurmix.ai/) is a unified AI gateway providing access to models from Anthropic, Google, OpenAI, and DeepSeek through an OpenAI-compatible API. To use FuturMix with goose, you need an API key from [FuturMix](https://futurmix.ai/). + +FuturMix offers models that support tool calling, including: +- **claude-sonnet-4-20250514** - Anthropic Claude Sonnet 4 with 200K context +- **gpt-4o** - OpenAI GPT-4o with 128K context +- **gemini-2.5-pro** - Google Gemini 2.5 Pro with 1M context +- **deepseek-chat** - DeepSeek V3 with 131K context +- **claude-haiku-4-20250514** - Anthropic Claude Haiku 4 with 200K context + +For the complete list of supported FuturMix models, see [futurmix.json](https://github.com/aaif-goose/goose/blob/main/crates/goose/src/providers/declarative/futurmix.json). + +To set up FuturMix with goose, follow these steps: + + + + **To update your LLM provider and API key:** + + 1. Click the button in the top-left to open the sidebar. + 2. Click the `Settings` button on the sidebar. + 3. Click the `Models` tab. + 4. Click `Configure Providers` + 5. Choose `FuturMix` as provider from the list. + 6. Click `Configure`, enter your API key, and click `Submit`. + 7. Select the FuturMix model of your choice. + + + + 1. Run: + ```sh + goose configure + ``` + 2. Select `Configure Providers` from the menu. + 3. Follow the prompts to choose `FuturMix` as the provider. + 4. Enter your API key when prompted. + 5. Select the FuturMix model of your choice. + + + ### Novita AI [Novita AI](https://novita.ai/) provides access to 90+ open-source models via an OpenAI-compatible API with competitive pricing. To use Novita AI with goose, you need an API key from [Novita AI](https://novita.ai/settings#key-management).