henergyqueai 0.1.0__tar.gz

henergyqueai-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+node_modules/
+dist/
+.env
+.env.*
+!.env.example
+# Private keys, certificates and local credential stores.
+*.pem
+*.key
+*.p12
+*.pfx
+*.crt
+*.cer
+*.der
+*.csr
+*.jks
+*.keystore
+id_rsa
+id_dsa
+id_ecdsa
+id_ed25519
+.ssh/
+# Local databases and SQLite journal/WAL companions.
+*.db
+*.db-*
+*.sqlite
+*.sqlite-*
+*.sqlite3
+*.sqlite3-*
+data/
+test-results/
+playwright-report/
+*.log
+artifacts/
+output/
+/CLAUDE CODE CLI/
+.npmrc
+**/.npmrc

henergyqueai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HenergyqueAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

henergyqueai-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.5
+Name: henergyqueai
+Version: 0.1.0
+Summary: Bibliothèque officielle de l’API HenergyqueAI : Velys, Oryne et Aelyr depuis Python.
+Project-URL: Homepage, https://henergyqueai.fr
+Project-URL: Documentation, https://henergyqueai.fr/plateforme/docs#bibliotheques
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aelyr,api,henergyqueai,ia,oryne,velys
+Classifier: Natural Language :: French
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.25
+Description-Content-Type: text/markdown
+
+# henergyqueai
+
+La bibliothèque officielle de l’API [HenergyqueAI](https://henergyqueai.fr) pour Python : Velys, Oryne et Aelyr en quelques lignes.
+
+- Python 3.9+, une seule dépendance (httpx).
+- Un client classique et un client asynchrone.
+- Streaming, outils, images, sorties JSON.
+- Nouvelles tentatives automatiques sur les erreurs passagères.
+
+```sh
+pip install henergyqueai
+```
+
+Créez une clé sur [henergyqueai.fr/plateforme/cles](https://henergyqueai.fr/plateforme/cles), puis :
+
+```sh
+export HENERGYQUEAI_API_KEY="hak_…"
+```
+
+## Premier appel
+
+```python
+from henergyqueai import HenergyqueAI
+
+client = HenergyqueAI()  # lit HENERGYQUEAI_API_KEY
+
+print(client.ask("Donne-moi trois idées de prénom pour un chat."))
+```
+
+`ask` utilise Velys par défaut :
+
+```python
+client.ask("Relis cette fonction.", model="oryne", system="Réponds en une phrase.")
+```
+
+## Conversation complète
+
+```python
+reponse = client.chat.create(
+    model="oryne",
+    messages=[
+        {"role": "system", "content": "Tu es un relecteur de code exigeant."},
+        {"role": "user", "content": "Que penses-tu de `for i in range(len(liste))` ?"},
+    ],
+    temperature=0.3,
+)
+
+print(reponse.text)  # le texte, déjà extrait
+print(reponse.usage.total_tokens)
+```
+
+Les réponses sont des dictionnaires dont les clés se lisent aussi comme des attributs : `reponse.choices[0].message.content` ou `reponse["choices"][0]["message"]["content"]`.
+
+## Streaming
+
+```python
+with client.chat.stream(
+    model="velys",
+    messages=[{"role": "user", "content": "Raconte une histoire courte."}],
+) as flux:
+    for texte in flux.text_stream:
+        print(texte, end="", flush=True)
+    finale = flux.final_completion()
+```
+
+## Client asynchrone
+
+```python
+import asyncio
+from henergyqueai import AsyncHenergyqueAI
+
+async def main():
+    async with AsyncHenergyqueAI() as client:
+        print(await client.ask("Bonjour !"))
+        flux = client.chat.stream(model="velys", messages=[{"role": "user", "content": "Un haïku."}])
+        async for texte in flux.text_stream:
+            print(texte, end="", flush=True)
+
+asyncio.run(main())
+```
+
+## Outils
+
+```python
+import json
+
+reponse = client.chat.create(
+    model="oryne",
+    messages=[{"role": "user", "content": "Quel temps fait-il à Nantes ?"}],
+    tools=[{
+        "type": "function",
+        "function": {
+            "name": "meteo",
+            "description": "La météo actuelle d’une ville",
+            "parameters": {"type": "object", "properties": {"ville": {"type": "string"}}, "required": ["ville"]},
+        },
+    }],
+)
+
+for appel in reponse.choices[0].message.get("tool_calls") or []:
+    ville = json.loads(appel.function.arguments)["ville"]
+    # … exécutez l’outil, puis renvoyez son résultat dans un message {"role": "tool", "tool_call_id": appel.id, "content": …}
+```
+
+## Format messages
+
+```python
+message = client.messages.create(
+    model="aelyr",
+    system="Tu es précis et concis.",
+    messages=[{"role": "user", "content": "Explique la différence entre TCP et UDP."}],
+)
+print(message.text)
+
+with client.messages.stream(model="aelyr", messages=[{"role": "user", "content": "Un haïku."}]) as flux:
+    for texte in flux.text_stream:
+        print(texte, end="")
+
+client.messages.count_tokens(model="velys", messages=[{"role": "user", "content": "Bonjour"}]).input_tokens
+```
+
+`max_tokens` vaut 1024 par défaut dans la bibliothèque.
+
+## Modèles et consommation
+
+```python
+[modele.id for modele in client.models.list()]  # ["velys", "oryne", "aelyr"]
+client.models.retrieve("oryne")
+client.usage().requests.remaining
+```
+
+## Erreurs
+
+```python
+from henergyqueai import RateLimitError, AuthenticationError
+
+try:
+    client.ask("Bonjour")
+except RateLimitError as erreur:
+    print(f"Réessayez dans {erreur.retry_after} s.")
+except AuthenticationError:
+    print("Clé invalide.")
+```
+
+Chaque erreur porte `status`, `type`, `code`, `param`, `request_id` et `retry_after`. Les autres classes sont `InvalidRequestError`, `PermissionDeniedError`, `NotFoundError`, `ServerError`, `ConnectionError` et `TimeoutError`, toutes filles de `HenergyqueAIError`.
+
+Les erreurs passagères (429, 5xx, coupure réseau) sont retentées deux fois, en respectant `retry-after`. La limite quotidienne de votre offre n’est jamais retentée.
+
+## Options
+
+```python
+client = HenergyqueAI(
+    "hak_…",          # sinon HENERGYQUEAI_API_KEY
+    timeout=60.0,     # secondes (10 minutes par défaut)
+    max_retries=3,    # 2 par défaut
+)
+```
+
+## Licence
+
+MIT

henergyqueai-0.1.0/README.md

@@ -0,0 +1,161 @@
+# henergyqueai
+
+La bibliothèque officielle de l’API [HenergyqueAI](https://henergyqueai.fr) pour Python : Velys, Oryne et Aelyr en quelques lignes.
+
+- Python 3.9+, une seule dépendance (httpx).
+- Un client classique et un client asynchrone.
+- Streaming, outils, images, sorties JSON.
+- Nouvelles tentatives automatiques sur les erreurs passagères.
+
+```sh
+pip install henergyqueai
+```
+
+Créez une clé sur [henergyqueai.fr/plateforme/cles](https://henergyqueai.fr/plateforme/cles), puis :
+
+```sh
+export HENERGYQUEAI_API_KEY="hak_…"
+```
+
+## Premier appel
+
+```python
+from henergyqueai import HenergyqueAI
+
+client = HenergyqueAI()  # lit HENERGYQUEAI_API_KEY
+
+print(client.ask("Donne-moi trois idées de prénom pour un chat."))
+```
+
+`ask` utilise Velys par défaut :
+
+```python
+client.ask("Relis cette fonction.", model="oryne", system="Réponds en une phrase.")
+```
+
+## Conversation complète
+
+```python
+reponse = client.chat.create(
+    model="oryne",
+    messages=[
+        {"role": "system", "content": "Tu es un relecteur de code exigeant."},
+        {"role": "user", "content": "Que penses-tu de `for i in range(len(liste))` ?"},
+    ],
+    temperature=0.3,
+)
+
+print(reponse.text)  # le texte, déjà extrait
+print(reponse.usage.total_tokens)
+```
+
+Les réponses sont des dictionnaires dont les clés se lisent aussi comme des attributs : `reponse.choices[0].message.content` ou `reponse["choices"][0]["message"]["content"]`.
+
+## Streaming
+
+```python
+with client.chat.stream(
+    model="velys",
+    messages=[{"role": "user", "content": "Raconte une histoire courte."}],
+) as flux:
+    for texte in flux.text_stream:
+        print(texte, end="", flush=True)
+    finale = flux.final_completion()
+```
+
+## Client asynchrone
+
+```python
+import asyncio
+from henergyqueai import AsyncHenergyqueAI
+
+async def main():
+    async with AsyncHenergyqueAI() as client:
+        print(await client.ask("Bonjour !"))
+        flux = client.chat.stream(model="velys", messages=[{"role": "user", "content": "Un haïku."}])
+        async for texte in flux.text_stream:
+            print(texte, end="", flush=True)
+
+asyncio.run(main())
+```
+
+## Outils
+
+```python
+import json
+
+reponse = client.chat.create(
+    model="oryne",
+    messages=[{"role": "user", "content": "Quel temps fait-il à Nantes ?"}],
+    tools=[{
+        "type": "function",
+        "function": {
+            "name": "meteo",
+            "description": "La météo actuelle d’une ville",
+            "parameters": {"type": "object", "properties": {"ville": {"type": "string"}}, "required": ["ville"]},
+        },
+    }],
+)
+
+for appel in reponse.choices[0].message.get("tool_calls") or []:
+    ville = json.loads(appel.function.arguments)["ville"]
+    # … exécutez l’outil, puis renvoyez son résultat dans un message {"role": "tool", "tool_call_id": appel.id, "content": …}
+```
+
+## Format messages
+
+```python
+message = client.messages.create(
+    model="aelyr",
+    system="Tu es précis et concis.",
+    messages=[{"role": "user", "content": "Explique la différence entre TCP et UDP."}],
+)
+print(message.text)
+
+with client.messages.stream(model="aelyr", messages=[{"role": "user", "content": "Un haïku."}]) as flux:
+    for texte in flux.text_stream:
+        print(texte, end="")
+
+client.messages.count_tokens(model="velys", messages=[{"role": "user", "content": "Bonjour"}]).input_tokens
+```
+
+`max_tokens` vaut 1024 par défaut dans la bibliothèque.
+
+## Modèles et consommation
+
+```python
+[modele.id for modele in client.models.list()]  # ["velys", "oryne", "aelyr"]
+client.models.retrieve("oryne")
+client.usage().requests.remaining
+```
+
+## Erreurs
+
+```python
+from henergyqueai import RateLimitError, AuthenticationError
+
+try:
+    client.ask("Bonjour")
+except RateLimitError as erreur:
+    print(f"Réessayez dans {erreur.retry_after} s.")
+except AuthenticationError:
+    print("Clé invalide.")
+```
+
+Chaque erreur porte `status`, `type`, `code`, `param`, `request_id` et `retry_after`. Les autres classes sont `InvalidRequestError`, `PermissionDeniedError`, `NotFoundError`, `ServerError`, `ConnectionError` et `TimeoutError`, toutes filles de `HenergyqueAIError`.
+
+Les erreurs passagères (429, 5xx, coupure réseau) sont retentées deux fois, en respectant `retry-after`. La limite quotidienne de votre offre n’est jamais retentée.
+
+## Options
+
+```python
+client = HenergyqueAI(
+    "hak_…",          # sinon HENERGYQUEAI_API_KEY
+    timeout=60.0,     # secondes (10 minutes par défaut)
+    max_retries=3,    # 2 par défaut
+)
+```
+
+## Licence
+
+MIT

henergyqueai-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "henergyqueai"
+version = "0.1.0"
+description = "Bibliothèque officielle de l’API HenergyqueAI : Velys, Oryne et Aelyr depuis Python."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+dependencies = ["httpx>=0.25,<1"]
+keywords = ["henergyqueai", "api", "ia", "velys", "oryne", "aelyr"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Natural Language :: French",
+  "Typing :: Typed",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://henergyqueai.fr"
+Documentation = "https://henergyqueai.fr/plateforme/docs#bibliotheques"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/henergyqueai"]

henergyqueai-0.1.0/src/henergyqueai/__init__.py

@@ -0,0 +1,37 @@
+"""Bibliothèque officielle de l'API HenergyqueAI."""
+
+from ._client import AsyncHenergyqueAI, HenergyqueAI
+from ._errors import (
+    AuthenticationError,
+    ConnectionError,
+    HenergyqueAIError,
+    InvalidRequestError,
+    NotFoundError,
+    PermissionDeniedError,
+    RateLimitError,
+    ServerError,
+    TimeoutError,
+)
+from ._streaming import AsyncChatStream, AsyncMessageStream, ChatStream, MessageStream
+from ._types import Result
+from ._version import __version__
+
+__all__ = [
+    "HenergyqueAI",
+    "AsyncHenergyqueAI",
+    "Result",
+    "ChatStream",
+    "MessageStream",
+    "AsyncChatStream",
+    "AsyncMessageStream",
+    "HenergyqueAIError",
+    "InvalidRequestError",
+    "AuthenticationError",
+    "PermissionDeniedError",
+    "NotFoundError",
+    "RateLimitError",
+    "ServerError",
+    "ConnectionError",
+    "TimeoutError",
+    "__version__",
+]