Aller au contenu
Installer

Installer Neo.

Trois temps : la commande, ton modèle, ta première demande.

Sur cette page
  1. Commande ou application
  2. 1. Lancer la commande
  3. 2. Choisir ton modèle
  4. 3. Parler à Neo
  5. Mettre à jour, désinstaller
  6. En cas de souci

Commande ou application

Deux façons d’arriver au même Neo. La commande est la méthode de référence.

La commandeRecommandéLinux, macOS et Windows (essai). Pour un serveur, un VPS ou ton ordinateur. Sans droits d’administrateur.Suivre le guideNeo DesktopBêtaL’application installe Neo, le configure avec toi et te laisse travailler sans terminal. Pour Linux, macOS et Windows.Télécharger l’application

1. Lancer la commande

Choisis ton système, copie la commande, colle-⁠la dans ton terminal.

curl -fsSL https://neo-agent.fr/install.sh | bash

Dans un terminal, avec ton utilisateur habituel.

Ce qu’il te faut

Une distribution courante (Debian, Ubuntu, Fedora, Arch, openSUSE ; pas Alpine), curl ou wget, et une clé chez un fournisseur de modèle ou un modèle local.

Ce que fait l’installateur

  1. Vérifie ton système et les outils nécessaires.
  2. Télécharge la dernière version depuis https://neo-agent.fr/releases/ et vérifie son empreinte SHA-256.
  3. Prépare Python avec uv, sans toucher au Python du système.
  4. Installe Neo dans ~/.local/share/neo et la commande neo dans ~/.local/bin, sans sudo (en root : /opt/neo).
  5. Lance neo setup pour choisir ton modèle, sauf si une configuration existe déjà.

Le lire avant de le lancer

curl -fsSL https://neo-agent.fr/install.sh -o install-neo.sh
less install-neo.sh
bash install-neo.sh

2. Choisir ton modèle

Anthropic, OpenAI, Gemini, OpenRouter ou un modèle local. L’installateur le lance pour toi.

  • neo setup

    Choisir le fournisseur et la clé, ou un modèle local avec Ollama. À relancer quand tu veux en changer.

Tu règles ton fournisseur directement. Ta configuration reste sur ta machine, dans ~/.neo.

Tu viens d’un autre agent (OpenClaw, Claude Code, Codex…) ? neo migrate auto reprend tes réglages, ta mémoire et tes compétences. Passer à Neo depuis un autre agent

3. Parler à Neo

Les trois commandes à connaître.

  • neo

    Parler à Neo dans le terminal.

  • neo gateway setup

    Le relier à ta messagerie.

  • neo doctor

    Vérifier que tout est en place.

Mettre à jour, désinstaller

Pour Linux. Change de système dans l’étape 1.

Mettre à jour

Relance la commande d’installation : elle installe la dernière version et garde la précédente (--version pour y revenir).

Options de l’installateur

--service
Garde Neo joignable en arrière-plan.
--complet
Ajoute ripgrep, ffmpeg et Node.js (sur Mac : la commande Homebrew à lancer).
--sans-config
Ne lance pas neo setup.
--migrate
Reprend les réglages d’un autre agent (OpenClaw, Claude Code, Codex…) avec neo migrate auto.
--aide
Toutes les options.

Exemple : | bash -s -- --service.

Désinstaller

  • curl -fsSL https://neo-agent.fr/install.sh | bash -s -- --desinstaller

    Retire Neo. Tes données restent dans ~/.neo.

  • curl -fsSL https://neo-agent.fr/install.sh | bash -s -- --desinstaller --purger

    Retire aussi ~/.neo. Définitif.

En cas de souci

Commence toujours par le diagnostic.

  • neo doctor

    Vérifie que tout est en place.

La commande neo est introuvable juste après l’installation ? Ouvre un nouveau terminal : il relit ton PATH.

Toujours bloqué ? Décris le souci, avec ton système et l’étape où ça coince :

Signaler un problème