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/guavaAuthenticate the CLI
guava loginCreate an Agent
Scaffold a new agent project with starter code (currently Python only).
guava create my-agentAdd 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-starterDeploy your Agent
guava deploy up ./my-agentTrack status in Deployments. Every call appears in Conversations.
Questions? hi@goguava.ai
# (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/guavaguava loginguava create my-agentgit clone https://github.com/goguava-ai/guava-starter.git my-agent/guava-starterguava deploy up ./my-agent