---
title: Installing and configuring Chatbox AI with Generative APIs
description: This page explains how to install and configure the Chatbox AI application with Scaleway's Generative APIs
tags: chatboxai generative-apis
products:
  - generative-apis
dates:
  validation: 2025-02-21
  posted: 2025-02-21
  validation_frequency: 12
difficulty: beginner
usecase:
  - build-and-run-ai
ecosystem:
  - third-party
---

Chatbox AI is a versatile desktop client compatible with various AI models. It offers installation packages for multiple platforms.

## Installing Chatbox AI

### From pre-built binaries

For most users, the easiest way is to use the pre-built packages available on the [Chatbox AI website](https://chatboxai.app/en) or mobile app stores:

- **Windows:** Download the installer from the [Chatbox AI website](https://chatboxai.app/en) and follow the on-screen instructions.
- **Linux:**
  1. Download the AppImage from the [Chatbox AI website](https://chatboxai.app/en).
  2. Make it executable:
     ```bash
     chmod +x ChatboxAI.AppImage
     ```
  3. Run the application.
- **macOS:** Choose the appropriate version (Intel or Apple silicon) from the [Chatbox AI website](https://chatboxai.app/en) and install it.
- **iOS:** Download and install the application from the official [App Store](https://apps.apple.com/app/chatbox-ai/id6471368056).
- **Android:** Download and install the application from [Google Play Store](https://play.google.com/store/apps/details?id=xyz.chatboxapp.chatbox).

### Installing from source (advanced)

For advanced users, Chatbox AI can be built from source:

1. Clone the Chatbox AI repository:
   ```bash
   git clone https://github.com/Bin-Huang/chatbox.git
   ```
2. Navigate to the project directory:
   ```bash
   cd chatbox
   ```
3. Install dependencies using `npm`:
   ```bash
   npm install
   ```
4. Start the application in development mode to verify it is working:
   ```bash
   npm run dev
   ```
5. Build the application and package the installer for your current platform:
   ```bash
   npm run package
   ```
6. (Optional) Build installers for all platforms:
   ```bash
   npm run package:all
   ```

For detailed installation instructions, refer to the [Chatbox GitHub repository](https://github.com/Bin-Huang/chatbox).

## Linking Chatbox AI with Scaleway Generative APIs

To use Scaleway Generative APIs with Chatbox AI, follow these steps:

1. Open the Chatbox AI application on your device.
2. Click the **settings icon** in the application's sidebar.
3. Navigate to the **Model** tab, select **Model provider** dropdown, and configure a new provider:
   - Click **Add Custom Provider** and enter:
     - **API Mode:** `OpenAI API Compatible`
     - **Name:** Scaleway
     - **API Host:** `https://api.scaleway.ai/v1/`
     - **API Path:** (leave empty)
     - **API Key:** Your Scaleway API key
     - **Model:** Enter the name of a [supported model](/generative-apis/reference-content/supported-models/).
       <Message type="tip">
       If you are unsure which model to use, start with `llama-3.1-8b-instruct`.
       </Message>
     - Leave other parameters at their default values.
4. Save the changes.
5. Start a new conversation and enter a prompt to test the AI model's response.

By following these steps, you have successfully installed Chatbox AI and integrated it with Scaleway’s Generative APIs.