Guava is a voice agent platform for developers. This repo is a starting point for building, exploring, and demoing Guava voice agents.
-
Install the SDK (Python >= 3.10 required):
pip install guava-sdk
-
Set your credentials:
export GUAVA_API_KEY="..." export GUAVA_AGENT_NUMBER="..."
-
Run an example to make sure everything works:
python -m guava.examples.scheduling_outbound +1... # your phone number
See docs/quickstart.md for the full setup guide.
docs/ SDK reference, quickstart, and use case guides
examples/ 65 working demos organized by vertical (healthcare, retail, etc.)
users/ Where you build your own demos
-
Create your folder under
users/:users/acme_corp/ -
Copy and fill out the PRD template:
cp users/prd.md users/acme_corp/prd.md
Open it and follow the instructions — you can fill it out manually or with an AI assistant.
-
Generate your demo — share your completed PRD with Claude (or another AI coding assistant) and ask it to build a Python demo in your folder:
users/acme_corp/ ├── prd.md # your spec └── __main__.py # your generated demo
Browse examples/ for patterns to reference or copy from. The more detail in your PRD, the better your output.
docs/quickstart.md— installation, setup, running examplesdocs/sdk-reference.md— full SDK referencedocs/use-cases.md— use case patterns and guidance