diff --git a/docs/customize/deep-dives/configuration.mdx b/docs/customize/deep-dives/configuration.mdx index 0668d9411..9ee3d2e76 100644 --- a/docs/customize/deep-dives/configuration.mdx +++ b/docs/customize/deep-dives/configuration.mdx @@ -1,18 +1,43 @@ --- title: "Configuration" -description: Configuration +description: Learn how to access and manage Continue assistant configurations through Hub or local YAML files keywords: [config, settings, customize] --- +Continue offers two ways to configure your AI assistants: Hub Assistants and Local Assistants (config.yaml). + You can easily access your assistant configuration from the Continue Chat sidebar. Open the sidebar by pressing cmd/ctrl + L (VS Code) or cmd/ctrl + J (JetBrains) and click the Assistant selector above the main chat input. Then, you can hover over an assistant and click the `new window` (hub assistants) or `gear` (local assistants) icon. ![configure an assistant](/images/configure-continue.png) ## Hub Assistants -Hub Assistants can be managed in [the Hub](https://hub.continue.dev). See [Editing an Assistant](../../hub/assistants/edit-an-assistant.md) +When you [sign in to Continue Hub](https://auth.continue.dev/), you get access to pre-configured assistants that sync automatically across your IDE sessions. To learn more about all the features available in Continue Hub, check out our [hub introduction](/hub/introduction). These assistants are: -## YAML Config +- **Easy to set up** - Add an assistant from [hub.continue.dev](https://hub.continue.dev/explore/assistants) to your account +- **Managed online** - Configure models, add secrets, and customize settings through the web interface +- **Automatically synced** - Changes made on the hub reflect immediately in your IDE +- **Shareable** - Create and share custom assistants with your team + +![nextjs assistant](/images/nextjs-assistant.png) + +To use Hub assistants: + +1. Click the assistant selector above the chat input in your IDE +2. Browse available assistants or create your own +3. Add API keys as [User Secrets](https://hub.continue.dev/settings/secrets) on the hub +4. Click "Reload config" to sync changes + +Hub Assistants can be managed in [the Hub](https://hub.continue.dev). See [Editing an Assistant](../../hub/assistants/edit-an-assistant.md) for more details. + +## Local Assistants (config.yaml) + +For advanced users who prefer local control, Continue supports configuration through a `config.yaml` file. Local assistants offer: + +- **Full control** - All configuration stored locally on your machine +- **Version control friendly** - Check your config into git for team consistency +- **Offline usage** - No internet required once models are configured +- **Advanced customization** - Access to all configuration options Local user-level configuration is stored and can be edited in your home directory in `config.yaml`: @@ -27,6 +52,23 @@ When editing this file, you can see the available options suggested as you type, See the full reference for `config.yaml` [here](/reference). +## Which Should You Use? + +**Choose Hub assistants if you:** + +- Want the quickest setup experience +- Prefer managing configuration through a web interface +- Want access to hosted models-addon +- Need to sync settings across multiple machines +- Want access to pre-configured assistants from the community + +**Choose local config.yaml if you:** + +- Need version control for your configuration +- Require advanced customization options +- Want complete offline control +- Prefer managing configuration as code + ## Deprecated configuration methods diff --git a/docs/getting-started/extensions.mdx b/docs/getting-started/extensions.mdx index 448ffad1a..10d386c20 100644 --- a/docs/getting-started/extensions.mdx +++ b/docs/getting-started/extensions.mdx @@ -3,52 +3,9 @@ title: "Understanding Assistants" description: "Continue offers two ways to configure your AI assistants" --- -### Hub Assistants +Continue offers flexible AI assistants that can be configured to match your development workflow. You can choose between: -When you [sign in to Continue Hub](https://auth.continue.dev/), you get access to pre-configured assistants that sync automatically across your IDE sessions. To learn more about all the features available in Continue Hub, check out our [hub introduction](/hub/introduction). These assistants are: +- **Hub Assistants** - Pre-configured assistants that sync across your IDE sessions +- **Local Assistants** - Fully customizable assistants managed through config.yaml -- **Easy to set up** - Add an assistant from [hub.continue.dev](https://hub.continue.dev/explore/assistants) to your account -- **Managed online** - Configure models, add secrets, and customize settings through the web interface -- **Automatically synced** - Changes made on the hub reflect immediately in your IDE -- **Shareable** - Create and share custom assistants with your team - -![nextjs assistant](/images/nextjs-assistant.png) - -To use Hub assistants: - -1. Click the assistant selector above the chat input in your IDE -2. Browse available assistants or create your own -3. Add API keys as [User Secrets](https://hub.continue.dev/settings/secrets) on the hub -4. Click "Reload config" to sync changes - -### Local Assistants (config.yaml) - -For advanced users who prefer local control, Continue supports configuration through a `config.yaml` file in your `~/.continue` directory. Local assistants offer: - -- **Full control** - All configuration stored locally on your machine -- **Version control friendly** - Check your config into git for team consistency -- **Offline usage** - No internet required once models are configured -- **Advanced customization** - Access to all configuration options - -To create a local assistant: - -1. Create a `config.yaml` file in `~/.continue` (see [config.yaml reference page](/reference)) -2. Configure your models, context providers, and other settings -3. Access local assistants through the gear icon in the assistant selector - -## Which Should You Use? - -**Choose Hub assistants if you:** - -- Want the quickest setup experience -- Prefer managing configuration through a web interface -- Want access to hosted models-addon -- Need to sync settings across multiple machines -- Want access to pre-configured assistants from the community - -**Choose local config.yaml if you:** - -- Need version control for your configuration -- Require advanced customization options -- Want complete offline control -- Prefer managing configuration as code +For detailed information about configuring assistants, including setup instructions and choosing between Hub and Local assistants, see our [configuration deep dive](/customize/deep-dives/configuration). \ No newline at end of file