> ## Documentation Index
> Fetch the complete documentation index at: https://doc.rapida.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Build natural-sounding AI voice assistants with ease

The Rapida SDK lets you quickly integrate voice, chat, and AI-powered workflows into your applications. This guide covers installation and authentication for different languages. For detailed API references, see the [API Reference](/api-reference).

<Columns cols={2}>
  <Card icon="audio-lines" title="Node.js Voice Agent" href="https://github.com/rapidaai/rapida-nodejs-recipes">
    A web voice AI assistant built with Node.js.
  </Card>

  <Card icon="audio-lines" title="Python Voice Agent" href="https://github.com/rapidaai/rapida-python-recipes">
    A voice AI assistant built with Python.
  </Card>

  <Card icon="audio-lines" title="Go Voice Agent" href="https://github.com/rapidaai/rapida-go-recipes">
    A voice AI assistant built with Go.
  </Card>

  <Card icon="audio-lines" title="React Voice Agent" href="https://github.com/rapidaai/rapida-react-recipes">
    A voice AI assistant built with React.
  </Card>
</Columns>

## Prerequisites

<Info>
  **Node.js and React**: Please install [Node.js](https://nodejs.org/en)
  (version 16.0.0 or higher) before proceeding.
</Info>

<Info>
  **Go**: Please install [Go](https://golang.org/dl/) (version 1.21 or higher)
  before proceeding.
</Info>

<Info>
  **Python**: Please install [Python](https://python.org/downloads/) (version
  3.9 or higher) before proceeding.
</Info>

You can check your installed versions:

<CodeGroup>
  ```bash Node.js theme={null}
  node --version
  ```

  ```bash Go theme={null}
  go version
  ```

  ```bash Python theme={null}
  python --version
  ```
</CodeGroup>

## Installation

<CodeGroup>
  ```bash React theme={null}
  # React (choose one)
  npm install @rapidaai/react      # npm
  yarn add @rapidaai/react         # yarn
  pnpm add @rapidaai/react         # pnpm
  ```

  ```bash Node.js theme={null}
  # Node.js (choose one)
  npm install @rapidaai/nodejs     # npm
  yarn add @rapidaai/nodejs        # yarn
  pnpm add @rapidaai/nodejs        # pnpm
  ```

  ```bash Go theme={null}
  # Go
  go get github.com/rapidaai/rapida-go@latest
  ```

  ```bash Python theme={null}
  # Python (choose one)
  pip install rapida-python        # pip
  pip3 install rapida-python       # pip3
  # Other languages: see tabs
  ```
</CodeGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Error: Module not found">
    This may be due to an incorrect package name or version.

    **Solution**:

    1. Verify you're using the correct package name for your platform
    2. Check that you have the minimum required version of Node.js, Go, or Python
    3. Try reinstalling the package
  </Accordion>

  <Accordion title="Authentication errors">
    This usually indicates invalid or missing credentials.

    **Solution**:

    1. Verify your API keys are correct in your `.env` file
    2. Check that your environment variables are being loaded properly
    3. Ensure you're using the right authentication method (Personal Token vs SDK API Key)
  </Accordion>

  <Accordion title="Go module issues">
    If you encounter Go module or dependency issues.

    **Solution**:

    1. Ensure Go modules are enabled: `go mod init your-project-name`
    2. Run `go mod tidy` to clean up dependencies
    3. Check that you're using Go 1.21 or higher
  </Accordion>

  <Accordion title="Node.js version compatibility">
    If you encounter issues with Node.js compatibility.

    **Solution**:

    1. Upgrade to Node.js 16.0.0 or higher
    2. Clear your npm cache: `npm cache clean --force`
    3. Remove `node_modules` and reinstall: `rm -rf node_modules && npm install`
  </Accordion>
</AccordionGroup>

## Next Steps

* Explore the [API Reference](/api-reference) for all available endpoints
* Learn how to configure [Assistants](/assistants/overview) and build custom experiences
* Read the [Authentication](/api-reference/authentication) guide to set up API access
* Review [API Reference](/api-reference/authentication) for all available endpoints