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é, clonez d'abord, exécutez ensuite :
gh auth login
git clone https://github.com/carlitoetienne01-spec/Diapason.git
cd Diapason && make setup # macOS, Linux, WSL2
Sur Windows natif, voir Native Windows install, dont la procédure est à jour.
Platform-specific guides¶
| Platform | Invocation depuis le clone authentifié | Detailed guide |
|---|---|---|
| macOS | bash scripts/install/install.sh |
macOS install |
| Linux | bash scripts/install/install.sh |
Linux install |
| WSL2 on Windows | bash scripts/install/install.sh (dans Ubuntu) |
WSL2 install |
| Native Windows | .\deploy\windows\install.ps1 |
Native Windows install |
| Desktop GUI | aucune release publiée ; construire depuis le clone | État Tauri |
The bash and PowerShell installers do the same thing on their respective hosts. The rest of this page documents the bash installer in detail; the native Windows guide is the equivalent reference for PowerShell.
Bash installer¶
The installer downloads everything for you — including uv (the Python package manager), the Python venv, Ollama, and a small starter model. You don't need to install uv or any other prerequisite first.
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.
About 3 minutes on a typical broadband connection. Type diapason to start chatting.
What the installer does¶
| Phase | Step | Where |
|---|---|---|
| Foreground | Install uv (Python package manager) |
~/.cargo/bin/ or ~/.local/bin/ |
| Foreground | Clone Diapason repo | ~/.diapason/src/ |
| Foreground | Create Python 3.11 venv | ~/.diapason/.venv/ |
| Foreground | uv pip install -e . (editable install) |
venv |
| Foreground | Install Ollama | system default |
| Foreground | Start ollama serve |
systemd-user / launchd / nohup |
| Foreground | Pull qwen3.5:2b (~1.5 GB) |
Ollama's model store |
| Foreground | Write config.toml (auto-detected hardware + engine + model) |
~/.diapason/config.toml |
| Foreground | Symlink diapason and diapason-uninstall |
~/.local/bin/ |
| Foreground | Add ~/.local/bin to PATH if missing (with on-screen notice) |
~/.bashrc or ~/.zshrc |
| Background | Install Rust toolchain via rustup | ~/.cargo/ |
| Background | Build the maturin extension (memory + security features) | venv |
| Background | Pull hardware-tier and tier+1 models | Ollama's model store |
What the installer does NOT touch¶
- Your existing Python installations
- Your
~/.bashrc/~/.zshrcother than appending one PATH line (with on-screen notice) - Your existing Ollama models
- Any other tool or dotfile
Idempotent re-runs¶
Re-running the local script is safe. The installer reads ~/.diapason/.state/install-state.json and skips completed steps. If your venv got nuked, re-running heals it.
Cloud quick-path¶
If any of these env vars are set when you install or run diapason init, the installer/init proposes cloud as the default and writes the matching provider into config.toml:
OPENROUTER_API_KEYANTHROPIC_API_KEYOPENAI_API_KEYGOOGLE_API_KEY(orGEMINI_API_KEY)
Local-first remains the default when no key is in env. Precedence is OpenRouter > Anthropic > OpenAI > Google.
Flags¶
| Flag | Effect |
|---|---|
--minimal |
Skip the foreground model pull. First chat will need to wait for the bg pull to finish. |
--no-bg-orchestrator |
Don't detach the background work pipeline. (Mostly for testing.) |
--force |
Re-run all steps even if install-state.json says they're done. |
Environment overrides¶
| Variable | Default | Purpose |
|---|---|---|
DIAPASON_HOME |
$HOME/.diapason |
Install location. |
DIAPASON_REPO_URL |
https://github.com/carlitoetienne01-spec/Diapason.git |
Source repo for the clone step. |
Uninstall¶
Removes ~/.diapason/, ~/.local/bin/diapason, and ~/.local/bin/diapason-uninstall. Leaves Ollama, uv, and the Rust toolchain in place (they may be used by other tools); the script prints removal hints.
Updating¶
Pulls the latest source, refreshes the editable install, and rebuilds the Rust extension in the background. Models are not touched.
Troubleshooting¶
"command not found: diapason"¶
~/.local/bin isn't on your PATH. Run source ~/.bashrc (or ~/.zshrc) or open a new terminal.
"memory features unavailable"¶
Rust extension hasn't finished building yet (or failed). Check status:
Manually retry:
A bigger model failed to download¶
Check status and retry:
Behind a corporate proxy¶
Set HTTPS_PROXY and CURL_CA_BUNDLE in your environment before running the installer.