Metadata-Version: 2.4
Name: brainus-ai
Version: 0.1.4
Summary: Official Python SDK for Brainus AI - RAG-powered educational content API
Project-URL: Homepage, https://developers.brainus.lk
Project-URL: Documentation, https://developers.brainus.lk/docs
Project-URL: Repository, https://github.com/BrainUsLK/brainus-ai-python
Project-URL: Issues, https://github.com/BrainUsLK/brainus-ai-python/issues
Project-URL: Changelog, https://github.com/BrainUsLK/brainus-ai-python/blob/main/CHANGELOG.md
Author-email: Brainus Team <dev@brainus.lk>
License: MIT
Keywords: ai,api,brainus,education,rag,sdk
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.9.0
Requires-Dist: typing-extensions>=4.12.0; python_version < '3.13'
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == 'dev'
Requires-Dist: mypy>=1.11.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Requires-Dist: twine>=5.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# Brainus AI Python SDK

Official Python SDK for the Brainus AI API - RAG-powered educational content queries with citations.

[![PyPI version](https://badge.fury.io/py/brainus-ai.svg)](https://badge.fury.io/py/brainus-ai)
[![Python Support](https://img.shields.io/pypi/pyversions/brainus-ai.svg)](https://pypi.org/project/brainus-ai/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- Async-first - Built with `httpx` for modern async/await patterns
- Type-safe - Full type hints with Pydantic models
- Automatic retries - Configurable retry logic for resilience
- Error handling - Custom exceptions for different error cases
- Citation support - Get source documents with page numbers
- Usage tracking - Monitor your API usage and quotas

## Installation

```bash
pip install brainus-ai
```

## Documentation

Full documentation, quick start guide, API reference, and examples are available at:

**https://developers.brainus.lk/docs/sdks/python**

## Resources

- [Documentation](https://developers.brainus.lk/docs/sdks/python)
- [Get API Key](https://developers.brainus.lk/dashboard/keys)
- [Support](https://github.com/BrainUsLK/brainus-ai-python/issues)
- [Website](https://brainus.lk)
- [Developer Portal](https://developers.brainus.lk)

## License

MIT License - see [LICENSE](LICENSE) for details.

---

Made with ❤️ by the Brainus team
