Skip to main content

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)

Source distribution for aiforge-esprit 0.1.3
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)

Table of built distributions (wheels) for aiforge-esprit 0.1.3
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page