Quickstart

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 instead.

Install the CLI

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

If you have Homebrew installed, you can install the CLI from our tap.

brew tap goguava-ai/tap
brew install goguava-ai/tap/guava

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

# Installs to `~/.local/bin/guava`
curl -fsSL https://goguava.ai/install.sh | sh

Authenticate the CLI

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

guava login

Create an Agent

Scaffold a new agent project with starter code (currently Python only).

guava create my-agent

Test your Agent

guava run ./my-agent

You can stop your agent by pressing Ctrl-C.

Deploy your Agent

guava deploy up ./my-agent

Track status in Deployments. Every call appears in Conversations.

Stop your agent after deploying

Be sure to stop your agent after deploying.

guava deploy down ./my-agent
→ Next: Inbound Example w/ RAG

Questions? hi@goguava.ai