# Voice agent quickstart (/en/ai/get-started/quickstart)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Set up a working voice agent in under five minutes. This page walks you through installing the Agora skills to give your AI coding assistant the official quickstarts and Agora CLI workflows. You then use the CLI to log in, clone the official starter, and run it locally. You can follow the CLI steps yourself or paste the sample prompt and let your assistant handle setup for you.

### Install Agora skills [#install-agora-skills]

Agora skills teaches your AI coding assistant how to work with Conversational AI projects using official starter repos and the Agora CLI, including signing in, project binding, generating environment files, and running diagnostics. Install the CLI in the next section, or ask your assistant to run the installer for you.

```bash
npx skills add AgoraIO/skills
```

Paste the following prompt into your assistant's chat. You can replace Python with TypeScript or Go depending on your language preference:

```text
Set up and run the Agora Conversational AI Python starter project locally.
```

Your assistant installs the CLI, signs you in, scaffolds the official starter, and guides you through the remaining steps. Follow the manual CLI steps below if you prefer to run each command yourself.

### Install the Agora CLI [#install-the-agora-cli]

The Agora CLI is a native Go binary available at [AgoraIO-Community/cli](https://github.com/AgoraIO-Community/cli).

<Tabs defaultValue="mac-linux" groupId="ai-install-os">
  <TabsList>
    <TabsTrigger value="mac-linux">
      macOS and Linux
    </TabsTrigger>

    <TabsTrigger value="windows-powershell">
      Windows (PowerShell)
    </TabsTrigger>
  </TabsList>

  <TabsContent value="mac-linux">
    ```bash
    curl -fsSL https://dl.agora.io/cli/install.sh | sh
    agora --help
    ```

    If the `agora` command is not found after installation, re-run with `--add-to-path` or
    manually add the install directory to your shell profile.
  </TabsContent>

  <TabsContent value="windows-powershell">
    ```powershell
    irm https://dl.agora.io/cli/install.ps1 | iex
    agora --help
    ```

    If your execution policy blocks inline scripts, download `install.ps1` and run:

    ```powershell
    powershell -ExecutionPolicy Bypass -File .\install.ps1
    ```
  </TabsContent>
</Tabs>

## Sign in, scaffold, and run [#sign-in-scaffold-and-run]

Sign in with the Agora CLI, clone the starter project, and configure it for your chosen language.

1. Sign in to Agora Console.

   ```bash
   agora login
   ```

2. Use `agora init` to clone the official starter for your chosen template, bind it to your
   Agora project, and write the runtime-specific environment file.

<Tabs defaultValue="python" groupId="ai-sdk-language">
  <TabsList>
    <TabsTrigger value="python">
      Python
    </TabsTrigger>

    <TabsTrigger value="typescript">
      TypeScript
    </TabsTrigger>

    <TabsTrigger value="go">
      Go
    </TabsTrigger>
  </TabsList>

  <TabsContent value="python">
    ```bash
    agora init my-python-demo --template python
    cd my-python-demo
    bun install
    bun run dev
    ```
  </TabsContent>

  <TabsContent value="typescript">
    ```bash
    agora init my-nextjs-demo --template nextjs
    cd my-nextjs-demo
    pnpm install
    pnpm dev
    ```
  </TabsContent>

  <TabsContent value="go">
    ```bash
    agora init my-go-demo --template go
    cd my-go-demo
    make setup
    make dev
    ```
  </TabsContent>
</Tabs>

3. Open `http://localhost:3000` and click **Start conversation**.

If the agent does not join or transcripts do not appear, run `agora project doctor` to
check credential validity, feature enablement, and network reachability.

## Next steps [#next-steps]

Explore the following topics:

* [Start and stop an agent](../build/start-stop-agent): Create and end a voice agent session with the REST API.
* [Use managed mode](../build/custom-model-integration/managed-mode): Start with Agora-managed ASR, LLM, and TTS providers.
* [Optimize conversation latency](../best-practices/optimize-latency): Tune ASR, LLM, TTS, and deployment choices.
* [Optimize audio](../best-practices/audio-setup): Apply recommended client audio settings.
* [REST API reference](/en/api-reference/api-ref/conversational-ai): Review exact request and response shapes.
* Explore the SDK API references for [TypeScript](/en/api-reference/api-ref/server-sdk/typescript), [Python](/en/api-reference/api-ref/server-sdk/python), and [Go](/en/api-reference/api-ref/server-sdk/go).