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 SmolLM3-3B
smart Qwen3.6-35B-A3B
coder Qwen3.6-27B
vision Gemma-3-4B-IT

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.1

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.1
File Size Uploaded Provenance Actions
aiforge_esprit-0.1.1.tar.gz 6.4 kB Without provenance Details for aiforge_esprit-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aiforge-esprit 0.1.1
File Interpreter ABI Platform Actions
aiforge_esprit-0.1.1-py3-none-any.whl Python 3 none any Details for aiforge_esprit-0.1.1-py3-none-any.whl

Total release size: 13.3 kB

Release files / aiforge_esprit-0.1.1.tar.gz

Download URL aiforge_esprit-0.1.1.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
848758697e5a9bf1732a201b555ecb291470eb088c69a74400b272c592b899c7
BLAKE2b-256 checksum
How to use checksums
382a1d68701cef80a971f4730bea0dcfa2777c1dcc3026e89c4374d9b035e176
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.1-py3-none-any.whl

Download URL aiforge_esprit-0.1.1-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2b2c758778900eb4f7bf5d7f03192edbe6dfe73a90bf923925eb07545f336243
BLAKE2b-256 checksum
How to use checksums
40d50c766033cf862ea6ee9bc8e344831127f2f4a061e94e8aa7d7abc878c524
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.1

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