Metadata-Version: 2.4
Name: gridspace-guava
Version: 0.21.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

## Documentation

Full documentation for the Python SDK can be found at [https://docs.goguava.ai/](https://docs.goguava.ai/).


## Installation

Install the Python SDK using your preferred package manager.

*Method 1: pip*
```bash
$ pip install gridspace-guava --extra-index-url https://guava-pypi.gridspace.com
```

*Method 2: uv astral*
```bash
$ uv add gridspace-guava --index guava=https://guava-pypi.gridspace.com
```

*Method 3: poetry*
```bash
$ poetry source add --priority=explicit guava https://guava-pypi.gridspace.com
$ poetry add --source guava gridspace-guava
```

## Running an Example

Set your environment variables.

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

Examples can be found in 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.
```