seaart 0.0.2

Unofficial Python client for SeaArt.ai API

🌀 SeaArt Python SDK

Lightweight, typed, and async-ready Python client for the SeaArt.ai API.

---

🚀 Installation

pip install seaart

⚙️ Quick Start

from seaart import SyncClient

with SyncClient() as client:
    login = client.login("[e-mail]", "password")
    print(f"Logged in as {login.email}")

or

from seaart import AsyncClient

async with AsyncClient() as client:
    login = await client.login("[e-mail]", "password")
    print(f"Logged in as {login.email}")

🔹 See more examples in examples/

---

💎 Highlights

• ⚡ Built on curl-cffi — fast, modern, and supports HTTP/2 + HTTP/3
• 🔄 Unified sync & async interfaces with identical APIs
• 🧱 Clean architecture built on BaseClient
• 🧩 Fully typed Pydantic v2 models
• 🧠 Low-level request() access for custom endpoints
• 💥 Meaningful, structured exceptions
• 🧪 Safe context manager support (with / async with)

---

📘 Documentation

Full documentation is coming soon.

For now, check out:

• examples/
• Docstrings inside src/seaart/_client.py
• Quick Start section above

---

🧩 TODO

Planned improvements and upcoming features:

• Add full API coverage (more endpoints, account & content methods)
• Implement detailed logging and debug mode
• Add unit tests and CI pipeline
• Improve exception handling and error messages
• Write comprehensive SDK documentation
• Add CLI tool for quick testing
• Add rate limiting and retry logic
• Enhance response models (more Pydantic schemas)

Want to contribute? Fork and open a PR — every improvement helps 💙

Requirements

Python 3.11 or higher.

---

_{Made with ❤️ by DeLaFault}

---