Fx

Fx est l'agent de codage de Vercel Labs, compilé en un unique binaire natif écrit en Zig, indépendant des modèles. Les connexions de modèles personnalisées se définissent dans le fichier utilisateur ~/.fx/settings.json, en pointant la base URL vers aicentos.

Un piège à connaître d'emblée : le .fx.json à la racine du projet est une autre affaire. Il interdit délibérément la plupart des champs (modèle compris), afin d'empêcher un dépôt cloné de remplacer votre modèle ou votre point d'accès. Une connexion de point d'accès personnalisé doit impérativement s'écrire dans ~/.fx/settings.json ; dans .fx.json, elle n'aurait aucun effet.

PrérequisCopier le lien d’ancre

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Fx (nommez-la par exemple fx, pour suivre plus facilement sa consommation) :

• Console : https://aicentos.com
• Créer une clé : https://aicentos.com/keys
• Recharger en cas de solde insuffisant : https://aicentos.com/wallet

Vérifiez que Fx est installé :

curl -fsSL https://fx.sh/setup.sh | bash
fx --version

Configuration à renseignerCopier le lien d’ancre

Étapes de configurationCopier le lien d’ancre

1. Éditer les réglages utilisateurCopier le lien d’ancre

Dans ~/.fx/settings.json, enregistrez une connexion au format « connexion de modèle personnalisée ». La structure des champs de l'objet de connexion fait foi dans la documentation officielle :

• Entrée de la documentation : https://fx.sh/docs
• README : https://github.com/vercel-labs/fx

Renseignez l'adresse API de la connexion ainsi :

https://aicentos.com/v1

Pour l'API Key, utilisez la clé créée dans la console ; pour les noms de modèles, référez-vous à la « place de marché des modèles » de la console.

2. Désigner cette connexionCopier le lien d’ancre

Fx permet de préciser provider et modèle au lancement :

fx provider local FX_MODEL=gpt-4o fx ask "Réponds en une phrase : combien font 1+1 ?"

Ou via une variable d'environnement :

export FX_MODEL="gpt-4o"

3. Vérifier le provider actuelCopier le lien d’ancre

Fx mémorise le choix par provider : au prochain démarrage, il reprend le provider précédent.

TestCopier le lien d’ancre

Commencez par vérifier la connectivité avec un prompt sans effet de bord :

fx ask "Réponds en une phrase : combien font 1+1 ?"

Une réponse normale signifie que la connexion fonctionne. En cas d'erreur d'authentification, vérifiez d'abord que la base URL contient bien /v1 et que l'API Key ne comporte pas d'espace parasite.

RemarquesCopier le lien d’ancre

• Ne modifiez pas .fx.json. Le fichier de projet n'accepte que quelques champs comme provider_order ou provider_strict, sans champ model, et ne sert pas à configurer un point d'accès personnalisé.
• provider_order / provider_strict sont des paramètres de routage du Vercel AI Gateway : ils ne s'appliquent qu'aux requêtes vers le Gateway et sont ignorés par les connexions de modèles personnalisées ; ne comptez pas sur eux pour changer d'amont.
• La prise en charge officielle des connexions de modèles personnalisées évolue encore ; sur les premières versions, une build récente peut être nécessaire pour la reconnaissance. Après une mise à jour, relancez d'abord la commande de test ci-dessus avant un usage sérieux.
• Le script d'installation du binaire télécharge depuis le réseau ; vérifiez vous-même la fiabilité de la source avant de l'exécuter.

Liens utilesCopier le lien d’ancre

• Page du projet : https://github.com/vercel-labs/fx