Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 1 addition & 4 deletions documentation/docs/getting-started/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -296,10 +296,7 @@ You can change your LLM provider or update your API key at any time.
1. Click the <PanelLeft className="inline" size={16} /> 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).
</TabItem>
<TabItem value="cli" label="Goose CLI">
1. Run the following command:
Expand Down
53 changes: 31 additions & 22 deletions documentation/docs/getting-started/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
**To update your LLM provider and API key:**
1. Click the <PanelLeft className="inline" size={16} /> 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. Click `Configure` on the LLM provider to update
6. Add additional configurations (API key, host, etc) then press `submit`
4. Click `Configure providers`
5. Click your provider in the list
6. Add your API key and other required configurations, then click `Submit`

**To change provider model**
**To change your current model:**
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
2. Click the `Settings` button on 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 <PanelLeft className="inline" size={16} /> button in the top-left to open 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
</TabItem>
<TabItem value="cli" label="Goose CLI">
1. Run the following command:
Expand All @@ -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.
Expand All @@ -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.
Expand All @@ -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.
Expand All @@ -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
```
</TabItem>
Expand Down Expand Up @@ -212,15 +221,15 @@ Goose supports using custom OpenAI-compatible endpoints, which is particularly u
<TabItem value="ui" label="Goose Desktop" default>
1. Click the <PanelLeft className="inline" size={16} /> 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. Click `OpenAI` in the provider list
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`
</TabItem>
<TabItem value="cli" label="Goose CLI">
1. Run `goose configure`
Expand Down