Installation¶
Les commandes d'une ligne ci-dessous ne fonctionnent pas
Elles vont chercher un script sur GitHub Pages. Ce dépôt est privé :
Pages ne publie rien, et ces URL rendent une page d'erreur — que iex ou
bash exécuteraient. Vérifié le 26 août 2026 : 404 sur install.sh, sur
install.ps1, et sur la racine du site.
Tant que le dépôt reste privé, clone d'abord, exécute ensuite :
gh auth login
git clone https://github.com/carlitoetienne01-spec/Diapason.git
cd Diapason && make setup # macOS, Linux, WSL2
Sur Windows natif, voir Installation sur Windows natif, dont la procédure est à jour.
Les guides par plateforme¶
| Plateforme | Invocation depuis le clone authentifié | Guide détaillé |
|---|---|---|
| macOS | bash scripts/install/install.sh |
Installation macOS |
| Linux | bash scripts/install/install.sh |
Installation Linux |
| WSL2 sur Windows | bash scripts/install/install.sh (dans Ubuntu) |
Installation WSL2 |
| Windows natif | .\deploy\windows\install.ps1 |
Installation sur Windows natif |
| Interface de bureau | aucune version publiée ; construire depuis le clone | État Tauri |
Les installateurs bash et PowerShell font la même chose, chacun sur son système. La suite de cette page décrit l'installateur bash en détail ; le guide Windows natif est la référence équivalente pour PowerShell.
L'installateur bash¶
L'installateur télécharge tout pour toi — dont uv (le gestionnaire de paquets Python), l'environnement virtuel Python, Ollama et un petit modèle de départ. Tu n'as rien à installer au préalable, pas même uv.
Publication future
La construction MkDocs copie toujours les scripts vers install.sh et
install.ps1, afin qu'ils soient prêts le jour où Pages sera réellement
publié. Aujourd'hui ces URL rendent 404 : le fichier local du clone est la
seule source exécutable annoncée.
Environ 3 minutes sur une connexion haut débit ordinaire. Tape diapason pour commencer à discuter.
Ce que fait l'installateur¶
| Phase | Étape | Où |
|---|---|---|
| Premier plan | Installe uv (le gestionnaire de paquets Python) |
~/.cargo/bin/ ou ~/.local/bin/ |
| Premier plan | Clone le dépôt Diapason | ~/.diapason/src/ |
| Premier plan | Crée l'environnement virtuel Python 3.11 | ~/.diapason/.venv/ |
| Premier plan | uv pip install -e . (installation éditable) |
l'environnement virtuel |
| Premier plan | Installe Ollama | emplacement par défaut du système |
| Premier plan | Démarre ollama serve |
systemd-user / launchd / nohup |
| Premier plan | Télécharge qwen3.5:2b (~1,5 Go) |
la réserve de modèles d'Ollama |
| Premier plan | Écrit config.toml (matériel détecté, moteur et modèle) |
~/.diapason/config.toml |
| Premier plan | Crée les liens diapason et diapason-uninstall |
~/.local/bin/ |
| Premier plan | Ajoute ~/.local/bin au PATH s'il y manque (avec un avis à l'écran) |
~/.bashrc ou ~/.zshrc |
| Arrière-plan | Installe la chaîne d'outils Rust via rustup | ~/.cargo/ |
| Arrière-plan | Construit l'extension maturin (mémoire et sécurité) | l'environnement virtuel |
| Arrière-plan | Télécharge les modèles du palier matériel et du palier au-dessus | la réserve de modèles d'Ollama |
Ce que l'installateur ne touche PAS¶
- Tes installations Python existantes
- Ton
~/.bashrc/~/.zshrc, hormis une ligne de PATH ajoutée à la fin (avec un avis à l'écran) - Tes modèles Ollama existants
- Tout autre outil ou fichier de configuration
Relancer sans risque¶
Relancer le script local ne casse rien. L'installateur lit ~/.diapason/.state/install-state.json et saute les étapes déjà faites. Si ton environnement virtuel a été détruit, une relance le répare.
Le chemin rapide vers le cloud¶
Si l'une de ces variables d'environnement est posée au moment de l'installation ou de diapason init, l'installateur (ou init) propose le cloud par défaut et écrit le fournisseur correspondant dans config.toml :
OPENROUTER_API_KEYANTHROPIC_API_KEYOPENAI_API_KEYGOOGLE_API_KEY(ouGEMINI_API_KEY)
Le local d'abord reste le défaut tant qu'aucune clé n'est dans l'environnement. L'ordre de priorité est OpenRouter > Anthropic > OpenAI > Google.
Les drapeaux¶
| Drapeau | Effet |
|---|---|
--minimal |
Saute le téléchargement du modèle au premier plan. La première discussion devra attendre la fin du téléchargement en arrière-plan. |
--no-bg-orchestrator |
Ne détache pas la chaîne de travail d'arrière-plan. (Surtout pour les tests.) |
--force |
Rejoue toutes les étapes, même celles qu'install-state.json dit terminées. |
Les variables d'environnement¶
| Variable | Défaut | Rôle |
|---|---|---|
DIAPASON_HOME |
$HOME/.diapason |
Où installer. |
DIAPASON_REPO_URL |
https://github.com/carlitoetienne01-spec/Diapason.git |
Le dépôt source de l'étape de clonage. |
Désinstaller¶
Retire ~/.diapason/, ~/.local/bin/diapason et ~/.local/bin/diapason-uninstall. Laisse Ollama, uv et la chaîne d'outils Rust en place (d'autres outils s'en servent peut-être) ; le script affiche les indications pour les retirer.
Mettre à jour¶
Récupère les dernières sources, rafraîchit l'installation éditable et reconstruit l'extension Rust en arrière-plan. Les modèles ne sont pas touchés.
Dépannage¶
« command not found: diapason »¶
~/.local/bin n'est pas dans ton PATH. Lance source ~/.bashrc (ou ~/.zshrc), ou ouvre un nouveau terminal.
« memory features unavailable »¶
L'extension Rust n'a pas fini de se construire — ou sa construction a échoué. Regarde où ça en est :
Pour relancer à la main :
Le téléchargement d'un gros modèle a échoué¶
Regarde où ça en est, puis relance :
Derrière un proxy d'entreprise¶
Pose HTTPS_PROXY et CURL_CA_BUNDLE dans ton environnement avant de lancer l'installateur.