Arrakis pour les agents
Votre agent peut chercher sur le marché, louer un GPU, lancer son job et arrêter la machine. Vous fixez le budget avant qu’il démarre, et il ne peut pas le dépasser.
Connexion en trois étapes
Arrakis sert MCP en HTTP depuis la même adresse que ce site. Rien à installer.
-
Créez un jeton pour votre agent
Dans la console, ouvrez API & agents et choisissez un jeton pour agent. Il reçoit les portées read et rent, un plafond de dépenses et une durée de location maximale. Depuis la CLI :
arrakis tokens create --name eval-agent \ --scope read --scope rent \ --spend-limit 50 --max-rental-hours 6 --expires-in 7d -
Ajoutez l’endpoint MCP
Utilisez le jeton comme en-tête bearer.
Connexion via MCPclaude mcp add --transport http arrakis $ARRAKIS_URL/mcp \ --header "Authorization: Bearer ark_..."{ "mcpServers": { "arrakis": { "url": "$ARRAKIS_URL/mcp", "headers": { "Authorization": "Bearer ark_..." } } } }Transport Streamable HTTP URL $ARRAKIS_URL/mcp Header Authorization: Bearer ark_...export ARRAKIS_TOKEN=ark_... export ARRAKIS_BASE_URL=$ARRAKIS_URL arrakis mcp$ARRAKIS_URLest l’adresse de ce site. Remplacezark_...par un jeton d’API de la console. -
Confiez-lui un job
Indiquez combien de temps la machine peut tourner. Votre agent transmet cette durée comme heure de suppression.
Lance ma suite d’évaluation sur une B200 : loues-en une pour trois heures, exécute eval.py, rapatrie les résultats, puis supprime-la.
Treize outils
Chaque outil annonce son coût avant que votre agent l’appelle. Les erreurs sont renvoyées avec l’explication fournie par l’API.
| Outil | Ce qu’il fait | Coût |
|---|---|---|
| search_gpus | Liste les machines disponibles, les meilleures d’abord, selon les capacités du GPU, son prix et la fiabilité de son hôte, filtrées par GPU, nombre, mémoire, prix par heure de GPU et pays. Il en recommande une et explique pourquoi. | Gratuit |
| get_market_summary | Le prix le plus bas et l’offre de chaque famille de GPU en ce moment. | Gratuit |
| get_balance | Le solde du compte, le coût horaire des machines en marche, le moment où l’argent s’épuise et le plafond du jeton. | Gratuit |
| rent_gpu | Loue une machine pour au plus termination_hours et renvoie sa commande SSH, le coût au pire des cas et le nombre d’heures que le solde peut payer. Une nouvelle tentative renvoie la même machine. | Prix horaire, heure par heure, jusqu’à la suppression |
| deploy_model | Déploie n’importe quel modèle Hugging Face avec vLLM, SGLang ou llama.cpp sur une machine dimensionnée pour lui, et renvoie son endpoint compatible OpenAI et sa clé d’API. La machine dispose aussi d’un accès SSH root. | Prix horaire, heure par heure, jusqu’à la suppression |
| list_images | Les images qu’une machine peut démarrer : les images Arrakis et celles du compte, y compris les images privées. rent_gpu accepte aussi n’importe quelle image publique. | Gratuit |
| list_instances | Les machines en marche sur le compte. | Gratuit |
| get_instance | L’état, la commande SSH et l’heure de suppression d’une machine, ainsi que tout avis de son hôte. | Gratuit |
| get_events | Ce qui est arrivé aux machines du compte : prêtes, terminées et pourquoi (évincées par leur hôte ou non), ainsi que les avis de leurs hôtes. | Gratuit |
| terminate_instance | Arrête une machine immédiatement. La facturation s’arrête avec elle. | Met fin aux frais |
| schedule_removal | Déplace l’heure de suppression d’une machine. | Modifie le coût maximal |
| get_partner_earnings | Pour les partenaires : vos codes, le lien et le message à partager, les clients que vous avez apportés, ce que vous avez gagné et pouvez retirer, et si le programme partenaire est ouvert. | Gratuit |
| join_partner_program | Inscrit le compte au programme partenaire, si son propriétaire est d’accord : un code partenaire, un lien et un message à partager. | Gratuit |
Ce qui protège les dépenses sans surveillance
Ces règles sont appliquées par l’API : elles valent aussi bien pour MCP que pour la CLI ou de simples requêtes HTTP.
Plafonds de dépenses
Un jeton plafonné compte chaque location au pire des cas, soit le prix horaire multiplié par le nombre d’heures avant la suppression, et refuse celle qui ferait dépasser le plafond.
Suppression obligatoire
Un jeton plafonné ne peut pas louer sans termination_hours, ni au-delà de sa durée de location maximale.
Nouvelles tentatives sans risque
La même idempotency_key renvoie toujours la même machine. Une nouvelle tentative ne loue jamais deux fois.
Jetons à portée limitée
Les portées read, rent, manage et billing sont distinctes. Un jeton ne peut pas en créer un autre doté de portées qu’il n’a pas.
Prépayé à l’heure
Une location paie sa première heure d’avance, puis chaque heure suivante au moment où elle commence. Quand le solde ne suffit plus, la machine s’arrête.
Expiration
Les jetons d’agent peuvent expirer à la date de votre choix. Un jeton expiré cesse de fonctionner partout à la fois.
Quand un hôte donne un préavis ou reprend une machine
Une machine spot peut être reprise à tout moment, et tout hôte peut tomber en panne. Arrakis prévient aussitôt votre agent.
Des alertes dans chaque résultat
Chaque résultat d’outil MCP contient les alertes des dernières 24 heures : un hôte qui annonce la reprise d’une machine ou une maintenance, un hôte qui ne répond plus, une éviction, un solde sur le point de s’épuiser.
Un flux d’événements
get_events et GET /v1/events listent les événements de chaque machine : prête, terminée et pourquoi, ainsi que les avis de son hôte.
Un webhook signé
Indiquez une URL dans la section Notifications de la console : vos agents reçoivent chaque événement dès qu’il se produit, signé avec Arrakis-Signature.
Rien n’est facturé pendant une panne
Aucune heure n’est facturée tant que l’hôte d’une machine ne répond pas, et toute heure commencée après qu’un hôte a repris une machine vous est rendue.
Gagnez de l’argent quand votre agent apporte des clients
Tout le monde peut rejoindre le programme partenaire, y compris les agents IA. Vous recevez un code partenaire et un lien, ainsi qu’une part de ce que paient les clients que vous apportez.
Rejoindre en un seul appel
join_partner_program inscrit au programme le compte pour lequel travaille votre agent, si vous êtes d’accord, et renvoie le code, le lien et un message à partager.
Une part de chaque paiement
Les nouveaux clients d’Arrakis qui paient avec votre code bénéficient d’une réduction sur leur premier paiement. Vous gagnez ensuite une part de tout ce qu’ils paient, recharges automatiques comprises.
Uniquement vos clients
get_partner_earnings liste les clients apportés par votre lien, avec ce que chacun a payé et vous a rapporté, sans jamais indiquer qui ils sont. Ajoutez une étiquette à vos liens pour voir quelle publication a fonctionné.
De l’argent ou des GPU
Retirez vos gains vers votre compte bancaire via Stripe, ou transférez-les sur votre solde pour les dépenser immédiatement en machines. Partout où vous recommandez Arrakis, indiquez que vous êtes rémunéré pour vos recommandations.
Un site lisible par les agents
Chaque page a son double en Markdown. Commencez par llms.txt.
- L’index pour les modèles de langage/llms.txt
- Tout le site dans un seul fichier/llms-full.txt
- Spécification OpenAPI 3.1/openapi.json
- Référence interactive de l’API/docs
- L’endpoint MCP et ses outils/docs/agents
- Chercher, louer, se connecter et arrêter/docs/rent
- Résumé du marché en temps réel, sans jeton/v1/market/summary
- Prix en temps réel de tous les GPU/gpus
- Cette page en Markdown/agents.html.md
Que lui demander
Des demandes simples suffisent. Donnez une limite de temps et un budget : votre agent respectera les deux.
Trouve le GPU le moins cher avec au moins 48 Go de mémoire, loue-le pour deux heures et dis-moi comment m’y connecter en SSH.
Lance un fine-tuning avec train.py sur quatre RTX 5090 pendant six heures au plus, rapatrie les checkpoints, puis arrête la machine.
Vérifie si une H200 est disponible. Si oui, donne-moi son prix par heure de GPU et le pays où elle tourne.
Questions sur les agents et les GPU
Tout le reste se trouve dans le guide MCP ou la référence de l’API.