> ## 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 (SDK-only)

> Install the Guava SDK directly and run an example agent

<Note>
  The recommended way to build Guava voice agents is using the [Guava CLI](/getting-started/quickstart), which bootstraps projects and installs the SDK.
  This guide explains how to install the SDK directly if you'd prefer not to use the CLI.
</Note>

## Create an account

Sign up for an account at [app.goguava.ai](https://app.goguava.ai).

## Install the SDK

Guava provides SDKs for Python and TypeScript. Choose your language and package manager.

<Tabs>
  <Tab title="Python">
    ```bash theme={null}
    uv add guava-sdk      # Install using uv (Recommended)
    pip install guava-sdk # Install using pip
    poetry add guava-sdk  # Install using poetry
    ```
  </Tab>

  <Tab title="TypeScript">
    ```bash theme={null}
    npm install @guava-ai/guava-sdk # Install using npm
    yarn add @guava-ai/guava-sdk    # Install using yarn
    pnpm add @guava-ai/guava-sdk    # Install using pnpm
    ```
  </Tab>
</Tabs>

## Set Environment Variables

The SDK reads credentials from the environment automatically. Set these before running any Guava scripts.

```bash .env theme={null}
export GUAVA_API_KEY="gva-..." # Set to your API key.
export GUAVA_AGENT_NUMBER="+15551234567" # Used by SDK examples. Set to your purchased number.
```

Create an API key using the [API Keys](https://app.goguava.ai/dashboard/api-keys) page. Purchase a phone number using the [Phone Numbers](https://app.goguava.ai/dashboard/phone-numbers) page.

## Add the coding agent starter kit

Download the Guava coding agent starter kit into your project. It contains plain-text API docs sized for AI coding assistants.

```bash theme={null}
curl -o guava-docs.md https://goguava.ai/docs/coding-agent-starter.md
```

## Run an Example

<Tabs>
  <Tab title="Python">
    Examples can be run directly from the Python SDK. You can browse the examples [on GitHub](https://github.com/goguava-ai/python-sdk/tree/main/guava/examples).

    ```bash theme={null}
    # This will attach your agent to a phone number. Dial that number to talk to your agent.
    python -m guava.examples.restaurant_waitlist --phone

    # Start a test call with a local audio device.
    python -m guava.examples.restaurant_waitlist --local

    # This will attach your agent to a WebRTC code.
    # You can dial it from the browser at https://app.goguava.ai/debug-webrtc
    python -m guava.examples.restaurant_waitlist --webrtc

    # Start an in-terminal text-only chat for testing.
    python -m guava.examples.restaurant_waitlist --chat
    ```
  </Tab>

  <Tab title="TypeScript">
    Examples can be run directly from the TypeScript SDK. You can browse the examples [on GitHub](https://github.com/goguava-ai/typescript-sdk/tree/main/examples).

    ```bash theme={null}
    # This will attach your agent to a phone number. Dial that number to talk to your agent.
    npx @guava-ai/guava-sdk restaurant-waitlist phone

    # Start a test call with a local audio device.
    npx @guava-ai/guava-sdk restaurant-waitlist local

    # This will attach your agent to a WebRTC code.
    # You can dial it from the browser at https://app.goguava.ai/debug-webrtc
    npx @guava-ai/guava-sdk restaurant-waitlist webrtc

    # Start an in-terminal text-only chat for testing.
    npx @guava-ai/guava-sdk restaurant-waitlist chat
    ```
  </Tab>
</Tabs>


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