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

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

Built distribution (wheel)

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

Total release size: 13.3 kB

Release files / aiforge_esprit-0.1.2.tar.gz

Download URL aiforge_esprit-0.1.2.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
94ea0305c8c2809637740d07993677f2f873cb1c8c2dd6696b996986b0f5c5f4
BLAKE2b-256 checksum
How to use checksums
2a8d8a8d5a3411d4acdb37f8fb5ce1ada646a1f931ca4dbf9d76a619d463fad3
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.2-py3-none-any.whl

Download URL aiforge_esprit-0.1.2-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
19d531adc1eb94ea0a68488ae57ecd00af17faf5388ad75b0db4eb2cf8af1ad6
BLAKE2b-256 checksum
How to use checksums
ffa270bc05c2ceb9be41091b78f31c373e0d358c48cb5b3bf761b950bd5cddbf
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.2

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