Metadata-Version: 2.4
Name: guava-sdk
Version: 0.25.0
Summary: The official Python SDK for building Guava voice agents.
Requires-Python: >=3.10
Requires-Dist: google-genai>=1.55.0
Requires-Dist: openai>=2.8.1
Requires-Dist: pydantic>=2.12.4
Requires-Dist: typing-extensions>=4.15.0
Requires-Dist: websockets>=15.0.1
Provides-Extra: chromadb
Requires-Dist: chromadb>=0.6.0; extra == 'chromadb'
Provides-Extra: lancedb
Requires-Dist: lancedb>=0.20.0; extra == 'lancedb'
Provides-Extra: pgvector
Requires-Dist: numpy>=1.26.0; extra == 'pgvector'
Requires-Dist: pgvector>=0.4.0; extra == 'pgvector'
Requires-Dist: psycopg[binary]>=3.2.0; extra == 'pgvector'
Provides-Extra: pinecone
Requires-Dist: pinecone>=5.0.0; extra == 'pinecone'
Description-Content-Type: text/markdown

# Guava Python SDK
[![PyPI - Version](https://img.shields.io/pypi/v/guava-sdk)](https://pypi.org/project/guava-sdk/)


## Documentation

Full documentation for the Python SDK can be found at [https://goguava.ai/docs](https://goguava.ai/docs). SDK examples can be found under [./examples/](https://github.com/goguava-ai/python-sdk/tree/main/examples).


## Installation

Install the SDK using your preferred package manager.

```bash
$ pip install guava-sdk
$ uv add guava-sdk
$ poetry add guava-sdk
```

## Running an Example

Set your environment variables.

```bash
$ export GUAVA_API_KEY="..."
$ export GUAVA_AGENT_NUMBER="..."
```

Examples can be run directly using the `guava.examples` submodule.

```bash
$ python -m guava.examples.scheduling_outbound +1... "John Doe" # Use your own phone number and name to receive a call.
```