aisberg 0.1.0__tar.gz

aisberg-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+Copyright © 2025 Free Pro. All rights reserved.
+
+This software and its source code are the exclusive property of Free Pro and are intended for internal use only.
+
+Unauthorized copying, distribution, modification, or use of this software, in whole or in part, is strictly prohibited without prior written permission from Free Pro.
+
+For questions or requests, contact:
+Free Pro
+[mathis.lambert@freepro.com]

aisberg-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: aisberg
+Version: 0.1.0
+Summary: Aisberg SDK for Python - A simple and powerful SDK to interact with the Aisberg API
+Author: Free Pro
+Author-email: Mathis Lambert <mathis.lambert@freepro.com>
+License: Private License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: License :: Other/Proprietary License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pydantic-settings>=2.10.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.1; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.1; extra == "dev"
+Requires-Dist: black>=25.1.0; extra == "dev"
+Requires-Dist: isort>=6.0.1; extra == "dev"
+Requires-Dist: mypy>=1.16.1; extra == "dev"
+Requires-Dist: flake8>=7.3.0; extra == "dev"
+Dynamic: license-file
+
+# Aisberg Python SDK
+
+![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-Private-informational)
+
+Aisberg SDK for Python is a robust and easy-to-use library for interacting with the Aisberg API.  
+It provides **synchronous** and **asynchronous** clients, advanced module abstractions, and built-in support for
+conversational LLM workflows, collections, embeddings, and more.
+
+---
+
+## Features
+
+- **Sync & Async clients**: Use with regular scripts or async frameworks
+- **Auto tool execution** for LLM flows (tool calls, results integration)
+- **Modular architecture**: Collections, chat, models, workflows, embeddings, and more
+- **Strong typing** via Pydantic models
+- **Environment-based configuration** (supports `.env` files and system environment variables)
+- **Context manager support** for easy resource management
+- **Custom tool registration**: Easily extend LLM capabilities with your own functions
+
+---
+
+## Installation
+
+```sh
+pip install aisberg
+````
+
+Or, for local development:
+
+```sh
+git clone https://your.git.repo/aisberg.git
+cd aisberg
+pip install -e .
+```
+
+---
+
+## Quickstart
+
+### 1. **Configure your API key and base URL**
+
+You can set them as environment variables, or in a `.env` file:
+
+```env
+AISBERG_API_KEY=...
+AISBERG_BASE_URL=https://url
+```
+
+### 2. **Synchronous Usage**
+
+```python
+from aisberg import AisbergClient
+
+with AisbergClient() as client:
+    me = client.me.info()
+    print(me)
+
+    chat_response = client.chat.complete(
+        input="Bonjour, qui es-tu ?",
+        model="llm-aisberg",
+    )
+    print(chat_response.choices[0].message.content)
+```
+
+### 3. **Asynchronous Usage**
+
+```python
+import asyncio
+from aisberg import AisbergAsyncClient
+
+
+async def main():
+    async with AisbergAsyncClient() as client:
+        await client.initialize()
+        me = await client.me.info()
+        print(me)
+
+        chat_response = await client.chat.complete(
+            input="Hello, who are you?",
+            model="llm-aisberg",
+        )
+        print(chat_response.choices[0].message.content)
+
+
+asyncio.run(main())
+```
+
+---
+
+## Modules
+
+* `client.me` — User/account info
+* `client.chat` — Conversational LLM completions and streaming
+* `client.collections` — Manage data collections
+* `client.embeddings` — Encode texts to embeddings
+* `client.models` — Model discovery & info
+* `client.workflows` — Workflow management & execution
+* `client.tools` — Register and execute tools for LLM tool calls
+
+Each module is available both in the sync and async clients with similar APIs.
+
+---
+
+## Tool Calls and Automatic Execution
+
+The SDK supports **tool-augmented LLM workflows**.
+Register your own functions for use in chat:
+
+```python
+def my_tool(args):
+    # Custom business logic
+    return {"result": "tool output"}
+
+
+client.tools.register("my_tool", my_tool)
+response = client.chat.complete(
+    input="Use the tool please.",
+    model="llm-aisberg",
+    tools=[{"name": "my_tool", ...}],
+    auto_execute_tools=True,
+)
+```
+
+---
+
+## Advanced Usage
+
+### **Custom Configuration**
+
+You can override configuration when instantiating the client:
+
+```python
+client = AisbergClient(
+    api_key="...",
+    base_url="https://url",
+    timeout=60,
+)
+```
+
+### **Environment Variables Supported**
+
+* `AISBERG_API_KEY`
+* `AISBERG_BASE_URL`
+* `AISBERG_TIMEOUT` (optional)
+
+### **Using in a Context Manager**
+
+Both clients are context manager compatible:
+
+```python
+with AisbergClient() as client:
+    # Sync usage
+    ...
+
+async with AisbergAsyncClient() as client:
+    # Async usage
+    ...
+```
+
+---
+
+## License
+
+**Private License — Not for public distribution or resale.**
+
+For enterprise/commercial use, please contact [Mathis Lambert](mailto:mathis.lambert@freepro.com) or Free Pro.
+
+---
+
+## Authors
+
+* Mathis Lambert
+* Free Pro
+
+---
+
+## Support
+
+For support, bug reports, or feature requests, please contact your technical representative.
+
+---

aisberg-0.1.0/README.md

@@ -0,0 +1,183 @@
+# Aisberg Python SDK
+
+![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
+![License](https://img.shields.io/badge/license-Private-informational)
+
+Aisberg SDK for Python is a robust and easy-to-use library for interacting with the Aisberg API.  
+It provides **synchronous** and **asynchronous** clients, advanced module abstractions, and built-in support for
+conversational LLM workflows, collections, embeddings, and more.
+
+---
+
+## Features
+
+- **Sync & Async clients**: Use with regular scripts or async frameworks
+- **Auto tool execution** for LLM flows (tool calls, results integration)
+- **Modular architecture**: Collections, chat, models, workflows, embeddings, and more
+- **Strong typing** via Pydantic models
+- **Environment-based configuration** (supports `.env` files and system environment variables)
+- **Context manager support** for easy resource management
+- **Custom tool registration**: Easily extend LLM capabilities with your own functions
+
+---
+
+## Installation
+
+```sh
+pip install aisberg
+````
+
+Or, for local development:
+
+```sh
+git clone https://your.git.repo/aisberg.git
+cd aisberg
+pip install -e .
+```
+
+---
+
+## Quickstart
+
+### 1. **Configure your API key and base URL**
+
+You can set them as environment variables, or in a `.env` file:
+
+```env
+AISBERG_API_KEY=...
+AISBERG_BASE_URL=https://url
+```
+
+### 2. **Synchronous Usage**
+
+```python
+from aisberg import AisbergClient
+
+with AisbergClient() as client:
+    me = client.me.info()
+    print(me)
+
+    chat_response = client.chat.complete(
+        input="Bonjour, qui es-tu ?",
+        model="llm-aisberg",
+    )
+    print(chat_response.choices[0].message.content)
+```
+
+### 3. **Asynchronous Usage**
+
+```python
+import asyncio
+from aisberg import AisbergAsyncClient
+
+
+async def main():
+    async with AisbergAsyncClient() as client:
+        await client.initialize()
+        me = await client.me.info()
+        print(me)
+
+        chat_response = await client.chat.complete(
+            input="Hello, who are you?",
+            model="llm-aisberg",
+        )
+        print(chat_response.choices[0].message.content)
+
+
+asyncio.run(main())
+```
+
+---
+
+## Modules
+
+* `client.me` — User/account info
+* `client.chat` — Conversational LLM completions and streaming
+* `client.collections` — Manage data collections
+* `client.embeddings` — Encode texts to embeddings
+* `client.models` — Model discovery & info
+* `client.workflows` — Workflow management & execution
+* `client.tools` — Register and execute tools for LLM tool calls
+
+Each module is available both in the sync and async clients with similar APIs.
+
+---
+
+## Tool Calls and Automatic Execution
+
+The SDK supports **tool-augmented LLM workflows**.
+Register your own functions for use in chat:
+
+```python
+def my_tool(args):
+    # Custom business logic
+    return {"result": "tool output"}
+
+
+client.tools.register("my_tool", my_tool)
+response = client.chat.complete(
+    input="Use the tool please.",
+    model="llm-aisberg",
+    tools=[{"name": "my_tool", ...}],
+    auto_execute_tools=True,
+)
+```
+
+---
+
+## Advanced Usage
+
+### **Custom Configuration**
+
+You can override configuration when instantiating the client:
+
+```python
+client = AisbergClient(
+    api_key="...",
+    base_url="https://url",
+    timeout=60,
+)
+```
+
+### **Environment Variables Supported**
+
+* `AISBERG_API_KEY`
+* `AISBERG_BASE_URL`
+* `AISBERG_TIMEOUT` (optional)
+
+### **Using in a Context Manager**
+
+Both clients are context manager compatible:
+
+```python
+with AisbergClient() as client:
+    # Sync usage
+    ...
+
+async with AisbergAsyncClient() as client:
+    # Async usage
+    ...
+```
+
+---
+
+## License
+
+**Private License — Not for public distribution or resale.**
+
+For enterprise/commercial use, please contact [Mathis Lambert](mailto:mathis.lambert@freepro.com) or Free Pro.
+
+---
+
+## Authors
+
+* Mathis Lambert
+* Free Pro
+
+---
+
+## Support
+
+For support, bug reports, or feature requests, please contact your technical representative.
+
+---

aisberg-0.1.0/aisberg/__init__.py

@@ -0,0 +1,7 @@
+from .client import AisbergClient
+from .async_client import AisbergAsyncClient
+
+__all__ = [
+    "AisbergClient",
+    "AisbergAsyncClient",
+]

aisberg-0.1.0/aisberg/abstract/modules.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+from abc import ABC
+from typing import TYPE_CHECKING, Union, Optional
+
+if TYPE_CHECKING:
+    from ..client import AisbergClient
+    from ..async_client import AisbergAsyncClient
+    from httpx import Client as HttpClient
+    from httpx import AsyncClient as AsyncHttpClient
+
+
+class BaseModule(ABC):
+    """Abstract base class for modules in the Aisberg framework."""
+
+    def __init__(
+        self,
+        parent: Union["AisbergClient", "AisbergAsyncClient"],
+        http_client: Optional[Union["HttpClient", "AsyncHttpClient"]] = None,
+    ):
+        """
+        Initialize the BaseModule.
+
+        Args:
+            parent (Any): Parent client or module.
+            http_client (Any): HTTP client for making requests.
+        """
+        self._parent = parent
+        self._client = http_client
+
+
+class SyncModule(BaseModule):
+    """Abstract base class for synchronous modules in the Aisberg framework."""
+
+    def __init__(self, parent: "AisbergClient", http_client: "HttpClient"):
+        """
+        Initialize the SyncModule.
+
+        Args:
+            parent (Any): Parent client or module.
+            http_client (Any): HTTP client for making requests.
+        """
+        super().__init__(parent, http_client)
+
+
+class AsyncModule(BaseModule):
+    """Abstract base class for asynchronous modules in the Aisberg framework."""
+
+    def __init__(self, parent: "AisbergAsyncClient", http_client: "AsyncHttpClient"):
+        """
+        Initialize the AsyncModule.
+
+        Args:
+            parent (Any): Parent client or module.
+            http_client (Any): HTTP client for making requests.
+        """
+        super().__init__(parent, http_client)