Metadata-Version: 2.2
Name: shadai
Version: 0.1.8
Summary: SHADAI Client
Author: SHADAI GROUP
Author-email: SHADAI GROUP <jaisir@shadai.ai>
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: boto3==1.35.36
Requires-Dist: botocore==1.35.36
Requires-Dist: pydantic==2.9.2
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: urllib3==2.2.3
Requires-Dist: requests==2.32.3
Requires-Dist: setuptools==75.3.0
Requires-Dist: tqdm==4.67.1
Requires-Dist: rich==13.9.4
Requires-Dist: ruff==0.8.4
Provides-Extra: dev
Requires-Dist: pytest==8.3.3; extra == "dev"
Dynamic: author

# SHADAI Intelligence Client

A Python client for interacting with the SHADAI Intelligence API. This client provides a simple interface for document processing, querying, and session management.

## Installation

```bash
pip install shadai
```

## Requirements

- Python >= 3.12
- Environment Variables:
  - `INTELLIGENCE_API_KEY`: Your SHADAI Intelligence API key

## Quick Start

```python
import asyncio
from shadai.intelligence.core.session import Session

async def main():
    async with Session(type="standard", delete_session=True) as session:
        await session.ingest(input_dir=input_dir)

        await session.query(
            query="¿De qué habla la quinta enmienda?", display_in_console=True
        )

        await session.get_summary(
            display_in_console=True
        )

        await session.create_article(
            topic="Enmiendas de los estados unidos y su impacto en la sociedad",
            display_in_console=True,
        )

if __name__ == "__main__":
    asyncio.run(main())
```

## Features

- Asynchronous API interactions
- Automatic session management
- File ingestion with progress tracking
- Interactive query interface
- Robust error handling and retries
- Rich console output

## Session Configuration

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| type | str | Processing type ("light", "standard", "deep") | "standard" |
| llm_model | str | Language model to use | None |
| llm_temperature | float | Model temperature | None |
| llm_max_tokens | int | Maximum tokens for response | None |
| query_mode | str | Query processing mode | None |
| language | str | Response language | None |
| delete_session | bool | Auto-delete session on exit | True |

## Error Handling

The client includes comprehensive error handling for:
- Configuration errors
- API communication issues
- File processing problems
- Session management failures



## Author

SHADAI GROUP <jaisir@shadai.ai>
