docs/Quickstart (SDK-only)

Quickstart (SDK-Only)

The recommended way to build Guava voice agents is using the Guava CLI, 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.

Create an account

Sign up for an account at app.goguava.ai.

Install the SDK

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

uv add guava-sdk      # Install using uv (Recommended)
pip install guava-sdk # Install using pip
poetry add guava-sdk  # Install using poetry

Set Environment Variables

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

.env
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 page. Purchase a phone number using the 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.

curl -o guava-docs.md https://goguava.ai/docs/coding-agent-starter.md

Run an Example

Examples can be run directly from the Python SDK. You can browse the examples on GitHub.

# Outbound call example. Use your own phone number and name to receive a call.
python -m guava.examples.scheduling_outbound +1... "John Doe"

# Inbound example. Dial your agent's number while the script is running.
python -m guava.examples.restaurant_waitlist
→ Next: Inbound Example w/ RAG

Questions? hi@goguava.ai