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

# Quickstart

> Install the Guava CLI and run your first voice agent

<Note>
  The recommended way to build Guava voice agents is using the Guava CLI, which bootstraps projects and installs the SDK.
  If you'd rather not install the CLI, you can skip to the [direct SDK installation guide](/getting-started/sdk-quickstart) instead.
</Note>

## Install the CLI

Install the CLI using one of the supported methods for your platform.

<Tabs>
  <Tab title="macOS">
    If you have Homebrew installed, you can install the CLI from our tap.

    ```bash theme={null}
    brew install goguava-ai/tap/guava
    ```

    If not, you can install using our provided shell script.

    ```bash theme={null}
    # Installs to `~/.local/bin/guava`
    curl -fsSL https://goguava.ai/install.sh | sh
    ```
  </Tab>

  <Tab title="Linux / WSL">
    For Linux and WSL, run the installation shell script.

    ```bash theme={null}
    # Installs to `~/.local/bin/guava`
    curl -fsSL https://goguava.ai/install.sh | sh
    ```
  </Tab>

  <Tab title="Windows">
    Run the installation script from a PowerShell console.

    ```bash theme={null}
    irm https://goguava.ai/install.ps1 | iex
    ```
  </Tab>

  <Tab title="Manual">
    Download the binary for your platform directly. After downloading, make the file executable and place it somewhere on your `PATH` (e.g. `~/.local/bin/`).

    Latest release: **v0.47.0**

    | Platform | SHA-256 |
    | - | - |
    | [macOS (Apple Silicon)](https://storage.googleapis.com/gridspace-guava-cli/cli/0.47.0/guava-darwin-aarch64) | `d6479b614cde049e19d6e3a914e5c647af0dee169d586eea7daa5517c54f5c9b` |
    | [macOS (Intel)](https://storage.googleapis.com/gridspace-guava-cli/cli/0.47.0/guava-darwin-x86_64) | `6cc3e4d08c8774bb36f6fb42c080ced4913e7b5a52dc9103afa86c1b39cf3a8a` |
    | [Linux (ARM64)](https://storage.googleapis.com/gridspace-guava-cli/cli/0.47.0/guava-linux-aarch64) | `750d5e8a74efb5c36a284a3d399980f38ef408af0092f62c7d59ff10e3d472b5` |
    | [Linux (x86\_64)](https://storage.googleapis.com/gridspace-guava-cli/cli/0.47.0/guava-linux-x86_64) | `8b731aa5ccccec45f804da5dd5faffaccd6690a5f05fefc3179789f39c52f256` |
    | [Windows (x86\_64)](https://storage.googleapis.com/gridspace-guava-cli/cli/0.47.0/guava-windows-x86_64.exe) | `61bf547ac29984d26b876749ba63b7d24c637da3a42816c1c866c63ef00edaea` |
  </Tab>
</Tabs>

## Authenticate the CLI

This command will open a browser where you can log in or create an account.

```bash theme={null}
guava login
```

## Create an Agent

Scaffold a new agent project with starter code.

```bash theme={null}
guava create my-agent
```

## Run your Agent

```bash theme={null}
guava run ./my-agent
```

You can stop your agent by pressing Ctrl-C.

<Note>
  If you're having trouble running your agent, try deploying.
</Note>

## (Optional) Deploy your Agent

Deploy your agent to Guava's servers.

```bash theme={null}
guava deploy up ./my-agent
```

Stop the deployment with `guava deploy down ./my-agent`. For more, see the [Deployment guide](/guides/deployment).

## Next Steps

<CardGroup cols={2}>
  <Card title="Architecture Overview" icon="gear" href="/getting-started/architecture-overview">
    Learn about how Guava works.
  </Card>

  <Card title="Inbound Q&A" icon="book" href="/getting-started/inbound-rag-example">
    Set up a basic inbound Q\&A agent using a knowledge base.
  </Card>

  <Card title="Automated Testing" icon="flask" href="/sdk-reference/agent-testing">
    Learn how to write automated tests for your agent.
  </Card>

  <Card title="Receiving WebRTC Calls" icon="globe" href="/guides/webrtc-calls">
    Set up a WebRTC agent.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.