From 5db41bb9e044020013719a208f3988c4b87b292b Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Wed, 20 Aug 2025 18:00:45 -0700 Subject: [PATCH 1/2] configure provider and model --- .../docs/getting-started/installation.md | 5 +- .../docs/getting-started/providers.md | 57 +++++++++++-------- 2 files changed, 34 insertions(+), 28 deletions(-) diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md index b91c929d4fd8..a23a2a21e4a3 100644 --- a/documentation/docs/getting-started/installation.md +++ b/documentation/docs/getting-started/installation.md @@ -296,10 +296,7 @@ You can change your LLM provider or update your API key at any time. 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 your provider - 6. Click `Configure`, enter your API key, and click `Submit`. - + 4. Choose to update your provider, switch models, or click `Reset Provider and Model` to clear your settings and return to the welcome screen. See details about these [configuration options](/docs/getting-started/providers#configure-provider). 1. Run the following command: diff --git a/documentation/docs/getting-started/providers.md b/documentation/docs/getting-started/providers.md index 94d2b4d3f52b..f3bd45815c95 100644 --- a/documentation/docs/getting-started/providers.md +++ b/documentation/docs/getting-started/providers.md @@ -56,28 +56,36 @@ CLI providers are cost-effective alternatives that use your existing subscriptio ## Configure Provider -To configure your chosen provider or see available options, run `goose configure` in the CLI or visit the `Settings` page in the Goose Desktop. +To configure your chosen provider or see available options, visit the `Models` tab in the Goose Desktop or run `goose configure` in the CLI. **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 + 2. Click the `Settings` in the sidebar 3. Click the `Models` tab - 4. Click `Configure Providers` - 5. Click `Configure` on the LLM provider to update - 6. Add additional configurations (API key, host, etc) then press `submit` + 4. Click `Configure providers` + 5. Choose your provider from the list and click `Configure` + 6. Add your API key and other required configurations, then click `Submit` - **To change provider model** + **To change your current model:** 1. Click the button in the top-left to open the sidebar - 2. Click the `Settings` button on the sidebar + 2. Click the `Settings` in the sidebar 3. Click the `Models` tab 4. Click `Switch models` - 5. Select a Provider from drop down menu - 6. Select a model from drop down menu - 7. Press `Select Model` + 5. Choose from your configured providers in the dropdown, or select `Use other provider` to configure a new one + 6. Select a model from the available options, or choose `Use custom model` to enter a specific model name + 7. Click `Select model` to confirm your choice - You can explore more models by selecting a `provider` name under `Browse by Provider`. A link will appear, directing you to the provider's website. Once you've found the model you want, return to step 6 and paste the model name. + :::tip Shortcut + For faster access, click your current model name at the bottom of the app and choose `Change Model`. + ::: + + **To start over with provider and model configuration:** + 1. Click the button in the top-left to open the sidebar + 2. Click the `Settings` in the sidebar + 3. Click the `Models` tab + 4. Click `Reset Provider and Model` to clear your current settings and return to the welcome screen 1. Run the following command: @@ -93,8 +101,10 @@ To configure your chosen provider or see available options, run `goose configure │ ◆ What would you like to configure? │ ● Configure Providers (Change provider or update credentials) - │ ○ Toggle Extensions │ ○ Add Extension + │ ○ Toggle Extensions + │ ○ Remove Extension + │ ○ Goose Settings └ ``` 3. Choose a model provider and press Enter. @@ -107,12 +117,11 @@ To configure your chosen provider or see available options, run `goose configure │ ◆ Which model provider should we use? │ ● Anthropic (Claude and other models from Anthropic) + │ ○ Azure OpenAI + │ ○ Amazon Bedrock + │ ○ Claude Code │ ○ Databricks - │ ○ Google Gemini - │ ○ Groq - │ ○ Ollama - │ ○ OpenAI - │ ○ OpenRouter + │ ○ ... └ ``` 4. Enter your API key (and any other configuration details) when prompted. @@ -127,7 +136,7 @@ To configure your chosen provider or see available options, run `goose configure │ Anthropic │ ◆ Provider Anthropic requires ANTHROPIC_API_KEY, please enter a value - │ + │ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪ └ ``` 5. Enter your desired `ANTHROPIC_HOST` or you can use the default one by hitting the `Enter` key. @@ -142,9 +151,9 @@ To configure your chosen provider or see available options, run `goose configure ◇ Model fetch complete │ ◇ Enter a model from that provider: - │ claude-3-5-sonnet-latest (default) + │ claude-sonnet-4-0 (default) │ - ◓ Checking your configuration... + ◓ Checking your configuration... └ Configuration saved successfully ``` @@ -212,15 +221,15 @@ Goose supports using custom OpenAI-compatible endpoints, which is particularly u 1. Click the button in the top-left to open the sidebar 2. Click the `Settings` button on the sidebar - 3. Next to `Models`, click the `browse` link - 4. Click the `configure` link in the upper right corner - 5. Press the `+` button next to OpenAI + 3. Click the `Models` tab + 4. Click `Configure providers` + 5. Choose `OpenAI` from the provider list and click `Configure` 6. Fill in your configuration details: - API Key (required) - Host URL (for custom endpoints) - Organization ID (for usage tracking) - Project (for resource management) - 7. Press `submit` + 7. Click `Submit` 1. Run `goose configure` From 2ff84f4cc031ddfbeb98f6323a6807c77c634430 Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Wed, 20 Aug 2025 18:19:55 -0700 Subject: [PATCH 2/2] tweak steps --- documentation/docs/getting-started/providers.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/docs/getting-started/providers.md b/documentation/docs/getting-started/providers.md index f3bd45815c95..6785aada9685 100644 --- a/documentation/docs/getting-started/providers.md +++ b/documentation/docs/getting-started/providers.md @@ -62,15 +62,15 @@ To configure your chosen provider or see available options, visit the `Models` t **To update your LLM provider and API key:** 1. Click the button in the top-left to open the sidebar - 2. Click the `Settings` in the sidebar + 2. Click the `Settings` button on the sidebar 3. Click the `Models` tab 4. Click `Configure providers` - 5. Choose your provider from the list and click `Configure` + 5. Click your provider in the list 6. Add your API key and other required configurations, then click `Submit` **To change your current model:** 1. Click the button in the top-left to open the sidebar - 2. Click the `Settings` in the sidebar + 2. Click the `Settings` button on the sidebar 3. Click the `Models` tab 4. Click `Switch models` 5. Choose from your configured providers in the dropdown, or select `Use other provider` to configure a new one @@ -83,7 +83,7 @@ To configure your chosen provider or see available options, visit the `Models` t **To start over with provider and model configuration:** 1. Click the button in the top-left to open the sidebar - 2. Click the `Settings` in the sidebar + 2. Click the `Settings` button on the sidebar 3. Click the `Models` tab 4. Click `Reset Provider and Model` to clear your current settings and return to the welcome screen @@ -223,7 +223,7 @@ Goose supports using custom OpenAI-compatible endpoints, which is particularly u 2. Click the `Settings` button on the sidebar 3. Click the `Models` tab 4. Click `Configure providers` - 5. Choose `OpenAI` from the provider list and click `Configure` + 5. Click `OpenAI` in the provider list 6. Fill in your configuration details: - API Key (required) - Host URL (for custom endpoints)