Installation.fr

Installation & Démarrage rapide

Ce guide vous aide à installer WorkPilot AI sur votre machine et à le lancer pour la première fois.

---

✅ Prérequis système

Configuration minimale

Ressource	Minimum	Recommandé
OS	Windows 10+ / macOS 10.15+ / Ubuntu 20.04+	Dernières versions
RAM	8 Go	16 Go
Stockage	2 Go libres	5 Go libres
Réseau	Connexion internet stable	—

Dépendances logicielles (développement depuis les sources)

• Node.js 20+ (la CI construit sur Node 22)
• Python 3.12+
• Git (dépôt initialisé obligatoire sur le projet cible)
• pnpm 8+
• Claude Code CLI (recommandé) — pnpm add -g @anthropic-ai/claude-code

---

🔽 Option 1 — Application de bureau (recommandé)

C'est la méthode la plus simple. Téléchargez l'installeur correspondant à votre plateforme depuis la page Releases.

Windows

1. Téléchargez WorkPilot-AI-<version>-win32-x64.exe
2. Double-cliquez sur l'installeur
3. Laissez Windows vérifier la signature puis lancez l'application

macOS

• Apple Silicon (M1/M2/M3) : WorkPilot-AI-<version>-darwin-arm64.dmg
• Intel : WorkPilot-AI-<version>-darwin-x64.dmg

Ouvrez le .dmg et glissez l'application dans Applications.

Linux

• AppImage (universel) : WorkPilot-AI-<version>-linux-x86_64.AppImage — rendez-le exécutable puis lancez-le
• Debian/Ubuntu : .deb installable via sudo dpkg -i
• Flatpak : .flatpak

Toutes les releases incluent des checksums SHA256 et des scans VirusTotal pour vérifier l'intégrité.

---

🛠 Option 2 — Depuis les sources (contributeurs)

# 1. Cloner le dépôt
git clone https://github.com/krovomi/WorkPilot-AI.git
cd WorkPilot-AI

# 2. Installer toutes les dépendances (Node + Python auto)
pnpm install

# 3. Lancer en mode développement (Electron + Vite HMR)
pnpm run dev

Le script crée automatiquement l'environnement virtuel Python et installe toutes les dépendances.

Installation manuelle (si l'automatique échoue)

# Backend Python
cd apps/backend
uv venv && uv pip install -r requirements.txt
# ou : python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt

# Frontend Electron
cd ../frontend
pnpm install
pnpm run dev

---

🔑 Configuration du fournisseur IA

À la première ouverture, WorkPilot AI vous guide pour configurer au moins un fournisseur IA.

Claude (recommandé — abonnement OAuth)

claude
# Tapez : /login
# Suivez le lien dans le navigateur

Le token OAuth est automatiquement sauvegardé dans le trousseau de votre OS (Keychain macOS / Credential Manager Windows / libsecret Linux).

Autres fournisseurs supportés

Fournisseur	Méthode	Variable
Anthropic Claude	OAuth / API Key	ANTHROPIC_API_KEY
OpenAI	OAuth / API Key	OPENAI_API_KEY
Google Gemini	API Key	GOOGLE_API_KEY
Grok / xAI	API Key	XAI_API_KEY
Ollama (local)	Endpoint	OLLAMA_BASE_URL
Azure OpenAI	API Key + Endpoint	AZURE_OPENAI_*
GitHub Copilot	OAuth	Via l'interface
Endpoint compatible OpenAI	API Key custom	Via l'interface

👉 Plus de détails : Fournisseurs IA

---

📁 Préparer votre projet

WorkPilot AI opère sur un dépôt Git initialisé. Assurez-vous que votre projet contient :

mon-projet/
├── .git/                  # obligatoire
├── package.json           # ou requirements.txt / Cargo.toml / go.mod…
└── …

La détection automatique de stack reconnaît les frameworks courants :

• Frontend : React, Vue, Angular, Svelte…
• Backend : Django, Flask, FastAPI, Express, NestJS…
• Langages : TypeScript, JavaScript, Python, Rust, Go, Java…
• Outils : Vite, Webpack, Cargo, Poetry, Maven, Gradle…
• Tests : Jest, Vitest, Pytest, Playwright, Cypress…

---

✔️ Vérification de l'installation

node --version       # v20 ou supérieur
python --version     # 3.12 ou supérieur
git --version
claude --version     # si Claude Code CLI installé

Dans l'application, ouvrez le panneau Paramètres → Diagnostic : toutes les lignes doivent être vertes.

---

❗ Dépannage rapide

Problème	Solution
Node.js introuvable	Réinstaller depuis nodejs.org avec l'option "Add to PATH"
Modules natifs (xterm, pty…)	cd apps/frontend && pnpm run rebuild
Python manquant	Installer Python 3.12+ puis l'ajouter au PATH
Token Claude expiré	claude puis /login
API Key invalide	Vérifier les variables d'environnement dans .env-files/.env
Problème OAuth	Révoquer dans les paramètres du fournisseur puis réautoriser
UI lente	Redémarrer l'app, fermer les autres terminaux IA

Besoin de plus ? ➡️ Dépannage complet

---

Prochaine étape

➡️ Votre premier projet