Open source, licence MIT

Installez le code libre, l'agent de codage gratuit pour votre terminal

free-code lit votre projet, modifie des fichiers avec un diff que vous approuvez, exécute vos tests et corrige ce qui échoue. Une ligne l'installe sur macOS, Linux ou Windows.

macOS / Linux / WSL
curl -fsSL https://free.ai/install.sh | sh
Windows (PowerShell)
irm https://free.ai/install.ps1 | iex

Pas de droits Python, pip ou admin nécessaires en premier. Exécutez de nouveau la même ligne pour la mettre à niveau.

Gratuit pour commencer: 6,000 jetons par jour sans compte, 30,000 par jour avec un compte libre confirmé.

Autres moyens d'installation

The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:

uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code

Le paquet npm a besoin de Python 3.9 ou plus récent sur la machine.

Installer une version spécifique

# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh

# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex

Pour forcer une méthode d'installation, définissez FREE_CODE_INSTALLER à uv, pipx ou vrv de la même manière.

Vérifiez que ça a marché.

free-code --version

Première manche

Ouvrez un terminal dans votre dossier de projet et démarrez une session. Ça marche tout de suite sans compte.

cd your-project
free-code

# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"

Le mode de sécurité est activé par défaut : vous voyez un diff et approuvez chaque modification et commande de fichier avant qu'il ne soit exécuté. La première fois, le code libre demande une fois si vous devez envoyer des rapports anonymes de crash. La réponse par défaut est non.

Connexion et clés API

La connexion augmente votre allocation quotidienne gratuite et vous permet d'utiliser des modèles payés à partir de votre solde symbolique. Votre navigateur s'ouvre à Free.ai, vous appuyez sur Approuver, et le CLI reçoit automatiquement une clé.

free-code login               # opens your browser
free-code login --no-browser  # over SSH: approve from any device with a short code
free-code login --manual      # paste a key or choose your own provider
free-code logout              # forget the key on this machine

Vous pouvez également créer une clé vous-même dans votre compte et la définir, ce qui est pratique pour les serveurs et les IC:

free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...

Créer un compte libre

Utilisez votre propre clé de fournisseur

free-code fonctionne également avec votre propre clé OpenAI, Anthropic, Google ou OpenRouter. Les demandes vont ensuite à ce fournisseur avec votre clé.

free-code config set provider anthropic
free-code config set api_key sk-ant-...

Choisir un modèle

code libre liste tous les modèles de Free.ai, les modèles de niveau libre d'abord. Les modèles de niveau gratuit ne coûtent pas de jetons dans votre allocation journalière; les modèles payés sont facturés en jetons.

free-code models               # chat models, free tier first
free-code models --free        # only models that cost no tokens
free-code models --type image  # image, video, tts, stt, ocr, music ...
free-code config set model <id>  # default model for new sessions

Dans une session, tapez /modèle pour basculer. Parcourir tous les modèles

Commandes communes

CommandeCe qu'il fait
free-codeDémarrer une session interactive dans ce dossier
free-code -cReprendre la dernière session de ce projet
free-code ask "..."Posez une question sur la base de codes
free-code run "..."Effectuer une tâche de codage
free-code -p "..."Imprimer la réponse et la sortie, pour les scripts et les CI
free-code sessionsListe des sessions sauvegardées que vous pouvez reprendre
free-code toolsAfficher les outils que l'agent peut utiliser et qui doivent être approuvés
free-code cloud "..." --repo URLExécutez une tâche dans le cloud Free.ai et obtenez un rapport
free-code tasksÉnumérez vos tâches de cloud récentes
free-code rcRegarder et conduire la session depuis l'application Free.ai
free-code mcp addConnexion d'un serveur MCP
free-code updateMise à jour vers la dernière version
free-code configAfficher vos paramètres

Outre l'édition de fichiers et de commandes en cours d'exécution, l'agent peut générer des images, des paroles, de la musique et de la vidéo dans votre projet, transcrire l'audio, lire du texte à partir de captures d'écran et de PDF, rechercher sur le Web avec des citations et traduire des fichiers locaux.

Chaque commande et option est dans le README sur GitHub

Mettre à jour et désinstaller

mise à jour de code libre par l'intermédiaire de tout ce qui l'a installé. Pour le supprimer, utilisez le même outil :

free-code update

uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code

Si l'installateur a créé son propre environnement, supprimez le dossier.free-code dans votre répertoire d'origine et le fichier free-code dans.local/bin. Vos paramètres et sessions sauvegardées vivent également dans le code.free.

Dépannage

code libre : commande introuvable

Le dossier d'installation n'est pas encore sur votre PATH. Sur Windows, ouvrez un nouveau terminal. Sur macOS ou Linux, ajoutez-le à votre profil shell et ouvrez un nouveau terminal :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc   # or ~/.zshrc

La limite anonyme gratuite pour aujourd'hui est épuisée

Lancez une connexion au code gratuit pour vous connecter et obtenir l'allocation quotidienne plus importante d'un compte gratuit, ou ajoutez des jetons pour utiliser des modèles payants. Voir prix

L'installateur ne peut pas télécharger uv

Certains réseaux bloquent astral.sh. Installez avec pipx ou pip à la place, ou définissez FREE_CODE_INSTALLER=venv pour utiliser votre propre Python 3.9 ou plus récent.

python3 -m verv a échoué sur Debian ou Ubuntu

Installez le paquet python3-venv avec apt, puis exécutez à nouveau la ligne d'installation.

Toujours coincé? Tapez /feedback à l'intérieur du code libre, ou ouvrez un problème sur GitHub. GitHub issues

FAQ

free-code est l'agent de codage Free.ai pour votre terminal. Il lit votre projet, modifie des fichiers avec un aperçu diff, exécute des commandes et des tests, et utilise des modèles Free.ai. Il est open source sous la licence MIT.

Oui. Il fonctionne sans compte sur une allocation journalière gratuite. Connectez-vous avec un code gratuit pour une plus grande indemnité journalière. Les modèles payants sont facturés en jetons et ont besoin d'un solde sur votre compte.

MacOS, Linux et Windows. Utilisez la ligne de boucle sur macOS, Linux et WSL, et la ligne PowerShell sur Windows. L'installateur utilise uv, qui récupère un Python approprié pour vous, donc il n'y a rien à configurer en premier.

Non. L'installateur met le code libre dans le dossier.local/bin de votre répertoire d'origine et ne demande jamais de droits d'administration.

Lancez la connexion au code libre. Votre navigateur s'ouvre à Free.ai, vous vous connectez et appuyez sur Approuver, et le CLI reçoit automatiquement une clé. Sur un serveur sur SSH, utilisez le code libre de connexion --no-browser et approuvez depuis n'importe quel périphérique avec le code court qu'il imprime.

Oui. Exécutez la connexion au code libre --manuelle pour coller une clé Free.ai ou choisissez votre propre fournisseur (OpenAI, Anthropic, Google ou OpenRouter). Les demandes vont ensuite à ce fournisseur avec votre clé.

Exécutez des modèles de code libre pour lister tous les modèles de Free.ai, avec d'abord des modèles de niveau libre. Ajouter --gratuit ou --payé au filtre. Interruptez dans une session avec /model, ou définissez un paramètre par défaut avec le modèle de configuration de code libre suivi de l'identifiant du modèle.

Les modifications de fichiers et les commandes sont exécutées sur votre machine. Le modèle reçoit les parties de votre projet qu'il doit répondre. Les rapports de crash anonymes sont désactivés à moins que vous ne les activiez, et ils n'incluent jamais votre code, vos instructions ou vos chemins de fichiers.

Exécutez la mise à jour du code libre. Il se met à niveau à travers tout ce qui l'a installé : uv, pipx, pip ou npm. Exécuter la ligne d'installation à nouveau aussi des mises à niveau. Une fois par jour, le code libre vous indique quand une nouvelle version existe; il ne s'installe jamais par lui-même.

Use the tool that installed it: uv tool uninstall freeai-code, pipx uninstall freeai-code, pip uninstall freeai-code or npm uninstall -g freeai-code. If the installer used its own private environment, delete the .free-code folder in your home directory and the free-code file in .local/bin.

Oui. free-code -p suivi d'une tâche imprime la réponse et sort. Ajouter --json pour un résultat JSON et --yes pour permettre les modifications de fichiers. Les commandes dangereuses restent bloquées même avec --yes, et le code de sortie vous indique si la tâche a réussi.

Il utilise le même compte Free.ai. free-code rc vous permet de regarder et conduire une session de terminal depuis l'application Free.ai ou depuis la page des sessions, et le cloud free-code exécute une tâche dans le cloud Free.ai et rend compte de nouveau.

Commencez à coder avec l'IA dans votre terminal

curl -fsSL https://free.ai/install.sh | sh

Windows et autres options d'installation · A propos de Free.ai Coder

Aimez Free.ai? Dites à vos amis!

Tu en veux plus? Inscription gratuite: 30 000 jetons/jour Inscription gratuite

Évaluer cette page