quickstart.md
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.
MacOS
If you have Homebrew installed, you can install the CLI from our 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
Linux
For Linux and WSL, run the installation shell script.
# Installs to `~/.local/bin/guava`
curl -fsSL https://goguava.ai/install.sh | sh
Windows
Run the installation script from a PowerShell console.
irm https://goguava.ai/install.ps1 | iex
Manual Installation
Download the binary for your platform directly. After downloading, make the file executable and place it somewhere on your PATH (e.g. ~/.local/bin/).
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