Skip to main content

aiforge

The official Python SDK for AI Forge ESPRIT — a thin wrapper around the OpenAI SDK.

aiforge 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

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

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

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.0
File Size Uploaded Provenance Actions
aiforge_esprit-0.1.0.tar.gz 6.2 kB Without provenance Details for aiforge_esprit-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 12.8 kB

Release files / aiforge_esprit-0.1.0.tar.gz

Download URL aiforge_esprit-0.1.0.tar.gz
Size 6.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e367feabb737634beedd2d3968e34a6a6299a99a90a6a085389844e591339656
BLAKE2b-256 checksum
How to use checksums
6ce0a95676696faa5f4b0211001ce13cfae00aff630019e55f585e1ba8ca1437
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.0-py3-none-any.whl

Download URL aiforge_esprit-0.1.0-py3-none-any.whl
Size 6.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be59965e4b517abdd2e00de1542f7fd0334388e2a01e95ec9cb8219e73a72e57
BLAKE2b-256 checksum
How to use checksums
e1683dbf1129d1a7844c3df2b432c3b53f163ba06d925dc570c3b640cb926d38
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.0

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