aiforge-esprit
The official Python SDK for AI Forge ESPRIT — a thin wrapper around the OpenAI SDK.
aiforge-esprit enrobe le SDK OpenAI officiel : il ne réimplémente jamais le
HTTP, il ajoute juste quatre macros et la facturation en TND.
Installation
pip install aiforge-esprit
Le paquet s'installe sous aiforge-esprit mais s'importe sous aiforge :
from aiforge import AIForge. (Le nom aiforge seul était indisponible sur PyPI.)
Démarrage rapide
from aiforge import AIForge
af = AIForge() # clé depuis AIFORGE_API_KEY
print(af.chat("Explique les transformers en 2 phrases."))
print(af.code("Écris un quicksort en Python"))
print(af.balance())
La clé vient de l'argument api_key= ou de la variable AIFORGE_API_KEY.
L'URL vient de base_url= ou de AIFORGE_BASE_URL (défaut :
https://aiforge.esprit.tn/api/v1).
Les trois niveaux de contrôle du modèle
| Niveau | Exemple | Coût de routage |
|---|---|---|
| Nom exact | chat(..., model="Qwen3.6-27B") |
aucun |
| Alias statique | chat(..., model="coder") |
aucun |
auto (défaut) |
chat(...) |
un appel classifieur |
En auto, un classifieur choisit le spécialiste selon la demande (et route vers
le modèle vision si une image est présente). Le champ model de la réponse porte
toujours le modèle réellement utilisé.
Alias
| Alias | Modèle |
|---|---|
fast |
Gemma-3-4B-IT |
smart |
Qwen3.6-27B |
coder |
Qwen3.6-35B-A3B |
vision |
Qwen3.6-35B-A3B |
Les 4 macros
af.chat(prompt, model="auto", system=None, max_tokens=2000, stream=False) # -> str (ou générateur si stream=True)
af.code(prompt) # chat model="coder", max_tokens=3000
af.extract(text, schema) # schema = classe pydantic ou dict json-schema -> instance validée
af.vision(image, prompt) # image = chemin local, bytes ou URL http(s)
af.balance() # -> {"balanceTND", "monthlyBudgetTND", "currency"}
Pour extract, le schéma garantit la forme ; le system prompt intégré impose la
concision (valeurs seules, sans phrases) ; pour des extractions complexes,
préférez model="smart". extract() tourne à temperature=0 par défaut
(déterminisme : même texte → même sortie structurée) ; passez temperature=...
pour introduire de la variance.
Avec AIForge(verbose=True), chaque appel imprime une ligne :
-> {modèle final} · {prompt}+{completion} tokens · {coût} TND.
Modèles à raisonnement (smart, coder)
Qwen3.6-27B et Qwen3.6-35B-A3B réfléchissent avant de répondre : la
réflexion arrive dans le champ reasoning de la réponse (nom vLLM 0.25). Un
max_tokens trop bas peut être entièrement consommé par la réflexion — le SDK
lève alors une erreur claire. Utilisez max_tokens >= 1500 pour smart et
coder.
Note de facturation
En mode auto, le coût du classifieur est imputé côté serveur (une ligne
d'usage distincte) mais n'apparaît pas dans la réponse — la ligne verbose
n'affiche donc que le coût du modèle final. Consultez la page Usage pour le
détail complet.
Licence
MIT — Direction IA - ESPRIT.
Metadata
Release files for aiforge-esprit 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aiforge_esprit-0.1.3.tar.gz | 6.5 kB | Without provenance | Details for aiforge_esprit-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aiforge_esprit-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for aiforge_esprit-0.1.3-py3-none-any.whl |
Total release size: 13.3 kB
Release files / aiforge_esprit-0.1.3.tar.gz
| Download URL | aiforge_esprit-0.1.3.tar.gz |
|---|---|
| Size | 6.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9cae98249ae7a484b23919c4671934fc2231d478a83b3aa972c9a21f727742dc
|
|
BLAKE2b-256 checksum How to use checksums |
167b953805370e4e9fe11baa1196105704b4d7a197dc4dc82781b326dd30e8c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Release files / aiforge_esprit-0.1.3-py3-none-any.whl
| Download URL | aiforge_esprit-0.1.3-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
33374580ba8fc5fe1a3055bb9e102a39beb38edf8dfb22ea169089f7dc9da718
|
|
BLAKE2b-256 checksum How to use checksums |
6776ad4673c18e5e46d3d9c87e3a6e15c265e71751fdc3a2f8811a255fe82f2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.7
|
Security for aiforge-esprit 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.