semvec/pypi-packages huggingface dataset:
foreva-ai 0.0.7
Voice AI for restaurants - Python SDK for Partners
Requires Python: >=3.8

# 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.
pyntagma 0.0.3
Pyntagma is a Python library for creating and managing complex data structures with ease. Its name is derived from the Greek word 'Syntagma', meaning 'composition', symbolizing that this package fits for semi-structured documents
Requires Python: >=3.9

# Pyntagma

[![Coverage Status](https://img.shields.io/badge/coverage-80%25-green.svg)](htmlcov/index.html)
[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

Pyntagma is a Python library for creating and managing complex data extraction pipelines with ease. Its name is derived from the Greek word 'Syntagma', meaning 'composition', symbolizing that this package fits for semi-structured documents.

## Features

- **PDF Document Processing**: Extract and analyze text, words, and lines from PDF documents
- **Multi-file Document Support**: Handle documents that span multiple PDF files
- **Precise Positioning**: Track exact coordinates and positions of text elements
- **Type-safe Design**: Built with Pydantic models for robust data validation
- **Silent PDF Processing**: Suppresses verbose logging during PDF operations
- **Flexible Cropping**: Extract specific regions from PDF pages

## Installation

Install Pyntagma using:

```bash
pip install pyntagma
```

## Quick Start

### Basic Document Processing

```python
from pyntagma import Document
from pathlib import Path

# Create a document from one or more PDF files
doc = Document(files=[
    Path("document-part1.pdf"),
    Path("document-part2.pdf")
])

# Access pages
print(f"Total pages: {len(doc.pages)}")

# Get the first page
page = doc.pages[0]
print(f"Page dimensions: {page.width} x {page.height}")

# Extract words and lines
words = page.words
lines = page.lines

print(f"Found {len(words)} words and {len(lines)} lines")
```

### Working with Text Elements

```python
# Access word properties
for word in page.words[:5]:  # First 5 words
    print(f"'{word.text}' at position ({word.x0}, {word.top})")
    print(f"Word dimensions: {word.x1 - word.x0} x {word.bottom - word.top}")

# Access line properties
for line in page.lines[:3]:  # First 3 lines
    print(f"Line: '{line.text}'")
    print(f"Line words: {len(line.words)}")
```

### Position-based Operations

```python
from pyntagma import Position, HorizontalCoordinate, VerticalCoordinate

# Create custom positions
position = Position(
    x0=HorizontalCoordinate(page=page, value=100),
    x1=HorizontalCoordinate(page=page, value=200),
    top=VerticalCoordinate(page=page, value=50),
    bottom=VerticalCoordinate(page=page, value=80)
)

# Check if one position contains another
word_position = page.words[0].position
if position.contains(word_position):
    print("Word is within the specified region")
```

### PDF Cropping

```python
from pyntagma import Crop

# Define a crop region
crop = Crop(
    path=Path("document.pdf"),
    page_number=0,
    x0=100.0,
    x1=400.0,
    top=50.0,
    bottom=200.0,
    padding=10,
    resolution=300
)

# Use the crop for further processing
print(f"Crop region: {crop}")
```