Skip to main content
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.
If not, you can install using our provided shell script.

Authenticate the CLI

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

Create an Agent

Scaffold a new agent project with starter code.

Run your Agent

You can stop your agent by pressing Ctrl-C.
If you’re having trouble running your agent, try deploying.

(Optional) Deploy your Agent

Deploy your agent to Guava’s servers.
Stop the deployment with guava deploy down ./my-agent. For more, see the Deployment guide.

Next Steps

Architecture Overview

Learn about how Guava works.

Inbound Q&A

Set up a basic inbound Q&A agent using a knowledge base.

Automated Testing

Learn how to write automated tests for your agent.

Receiving WebRTC Calls

Set up a WebRTC agent.