Metadata-Version: 2.4
Name: foreva-ai
Version: 0.0.7
Summary: Voice AI for restaurants - Python SDK for Partners
Home-page: https://foreva.ai/partners
Author: Foreva AI
Author-email: support@foreva.ai
Project-URL: Documentation, https://foreva.ai/partners/docs
Project-URL: Support, https://foreva.ai/partners/support
Project-URL: Dashboard, https://foreva.ai/partners/dashboard
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: typing-extensions>=4.0.0; python_version < "3.10"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Foreva AI Partner SDK

The official Python SDK for Foreva AI partners. Add voice AI to restaurants with just a few lines of code.

## Installation

```bash
pip install foreva-ai
```

## Quick Start

```python
from foreva_ai import ForevaAgent, MenuBuilder

# Create agent (get API key from partner dashboard)
agent = ForevaAgent("YOUR_API_KEY", "+14155551234")

# Configure restaurant
agent.set_store(
    name="Restaurant Name",
    address="123 Main St, City, State 12345",
    timezone="America/Los_Angeles"
)

# Set menu
menu = (MenuBuilder()
    .add_category(1, "Main Dishes")
    .add_item(101, "Pasta Special", 15.99, 1)
    .build())
agent.set_menu(menu)

# Activate
result = agent.activate()
print(f"Forward calls to: {result['routing_number']}")
```

## API Key & Usage

- **API Key**: `foreva_xxx...` (single key per partner)
- **Free Tier**: 100 minutes per account
- **Subscription**: Monthly base plan + pooled minutes

## Documentation

Complete documentation and examples:
**https://foreva.ai/partners/docs**

## Support

- **Email**: support@foreva.ai
- **Dashboard**: https://foreva.ai/partners/dashboard
- **Support Portal**: https://foreva.ai/partners/support

## License

This SDK is proprietary software for authorized Foreva AI partners only.
