docs/Quickstart

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.

Create an account

Sign up at app.goguava.ai.

Install the CLI

Pick an install method below.

# (macOS / Linux) Use the install script. Installs to `~/.local/bin/guava` 
curl -fsSL https://storage.googleapis.com/gridspace-guava-cli/cli/install.sh | sh

# (macOS) Install using Homebrew
brew tap goguava-ai/tap
brew install goguava-ai/tap/guava

Authenticate the CLI

guava login

Create an Agent

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

guava create my-agent

Add vibe-coding kit (optional)

Clone the Guava starter repository into your new agent project. It contains plain-text API docs and examples sized for AI coding assistants.

git clone https://github.com/goguava-ai/guava-starter.git my-agent/guava-starter

Deploy your Agent

guava deploy up ./my-agent

Track status in Deployments. Every call appears in Conversations.

Questions? hi@goguava.ai