Documentation mandy

mandy héberge des datasets et des modèles. Les deux suivent exactement le même cycle de vie : fichiers, fiche, licence, accès, versions, discussions. Un modèle gagne en plus un playground pour l'essayer sans rien installer.

Publier

1. Type & identité — dataset ou modèle, propriétaire (toi ou une organisation), nom, résumé, fichiers.
2. Fiche & licence — tâche, modalité, langues, tags, secteur, licence, et la fiche en Markdown.
3. Accès & inférence — gratuit, payant en FCFA, ou sur demande ; visibilité ; backend d'inférence pour les modèles.

Tout reste modifiable après publication depuis le bouton Modifier. Renseigner une note de version crée une nouvelle entrée dans l'onglet Versions.

La fiche

La fiche accepte un front-matter YAML, comme les repository cards de Hugging Face :

---
license: CC BY-SA 4.0
language:
- français
- dioula
pipeline_tag: automatic-speech-recognition
base_model: openai/whisper-small
---

Le front-matter est retiré de l'affichage ; le corps Markdown est rendu.

Visionneuse de données

Les fichiers CSV, TSV, JSONL, JSON et TXT sont lus directement dans l'onglet Données : table paginée, recherche plein texte, histogramme par colonne, et filtrage en cliquant sur une valeur fréquente. Les autres formats restent téléchargeables.

Playground {#api}

L'onglet Playground d'un modèle envoie l'entrée à POST /api/inference :

curl -X POST http://localhost:3000/api/inference \
  -F "repo_id=1" \
  -F "input=Bonjour, comment ça va ?"

La réponse contient le fournisseur utilisé, la latence, et la sortie — texte libre ou étiquettes avec scores selon la tâche.

Fournisseurs

Le serveur choisit dans cet ordre :

1. Hugging Face Inference Providers si HF_TOKEN est défini et que le modèle
déclare un backend d'inférence. Les tâches conversationnelles passent par l'endpoint compatible OpenAI https://router.huggingface.co/v1/chat/completions, les autres par https://router.huggingface.co/hf-inference/models/<id>.
2. API Claude si ANTHROPIC_API_KEY est défini. Le modèle claude-opus-5 joue le rôle
du modèle publié, guidé par sa fiche et sa tâche.
3. Simulation sinon — sortie déterministe, clairement signalée dans l'interface.

Configure les clés dans .env.local :

ANTHROPIC_API_KEY=sk-ant-...
HF_TOKEN=hf_...

Accès et paiement {#tarifs}

• Gratuit — téléchargement ouvert, attribution requise par la licence.
• Payant — prix unique en FCFA. L'achat débloque le téléchargement et alimente les revenus du profil.
• Sur demande — chaque demande arrive dans la colonne du dépôt ; tu acceptes ou refuses.

Les fichiers ne sont jamais servis en statique : /api/files/<id> vérifie la visibilité et le droit d'accès avant de streamer, et incrémente le compteur de téléchargements.

Clonage

Le bouton Cloner copie la fiche, les métadonnées et la liste des fichiers dans ton espace, en gardant le lien vers l'original. C'est l'équivalent d'un fork : le dépôt cloné repart en accès gratuit et en version v1.0.