---
description: >-
  This page will guide you through the process of setting up and managing AI
  providers in Waterflai.
---

# Providers setup

### Adding a New Provider

To add a new AI provider to your Waterflai workspace:

1. Navigate to the Providers page in your Waterflai dashboard.
2. Click the "Add Provider" button.
3. In the provider selection modal, you'll see a grid of available provider types.
4. Use the search bar at the top to filter providers if needed.
5. Click on the provider card you wish to add.
6. Fill out the provider-specific form with the required details (e.g., API keys, endpoints).
7. Click "Save" to create the new provider connection.

### Managing Existing Providers

Once you've added providers, you can manage them from the Providers table:

#### Viewing Providers

* The Providers table displays all your connected providers.
* Each row shows the provider's name and logo for easy identification.

#### Importing Models

To import models from a provider:

1. Click the brain icon next to the provider in the table.
2. Select the models you wish to import in the modal that appears.
3. Click "Import" to add the selected models to your workspace.

#### Editing a Provider

To edit a provider's settings:

1. Click the three-dot menu at the end of the provider's row.
2. Select "Edit" from the dropdown menu.
3. Update the provider's details in the form that appears.
4. Click "Save" to apply your changes.

#### Deleting a Provider

To remove a provider:

1. Click the three-dot menu at the end of the provider's row.
2. Select "Delete" from the dropdown menu.
3. Confirm the deletion in the confirmation dialog.

> **Note:** Deleting a provider will remove access to its models. Ensure you're not using any of the provider's models in active projects before deletion.

### Provider-Specific Setup

Each provider may have unique setup requirements. Here are some general guidelines:

* **API Keys**: Most providers require an API key. Ensure you have an account with the provider and have generated an API key before adding the provider to Waterflai.
* **Endpoints**: Some providers, especially self-hosted ones, may require you to specify an endpoint URL.
* **Model Selection**: Certain providers allow you to select which models you want to use. Make sure you have the necessary permissions for the models you select.

### Best Practices

1. **Security**: Store API keys securely and never share them.
2. **Testing**: After adding a provider, test the connection by importing and using a model.
3. **Monitoring**: Regularly check your provider usage to manage costs and performance.
4. **Updates**: Keep an eye out for provider updates that may require changes to your setup.

By following these instructions, you'll be able to efficiently set up and manage your AI providers in Waterflai, enabling you to leverage a wide range of AI models for your applications.
