WorkPilot-AI

Deployment & Team

---

Installation et Configuration

Méthodes d'Installation

Option 1 : Application Bureau (Recommandé)

1. Téléchargement - Visitez GitHub Releases - Téléchargez la version stable pour votre plateforme

2. Installation - Windows : Exécutez WorkPilot-AI-1.0.0-win32-x64.exe - macOS : Ouvrez WorkPilot-AI-1.0.0-darwin-arm64.dmg - Linux : Lancez WorkPilot-AI-1.0.0-linux-x86_64.AppImage

3. Premier Lancement - Lancez l'application - Suivez l'assistant de configuration - Connectez votre provider AI

Option 2 : Développement depuis Source

1. Clonage du Dépôt

   git clone https://github.com/krovomi/WorkPilot-AI.git
   cd WorkPilot-AI
   

2. Installation Automatique

   pnpm install
   pnpm run dev
   

1. Lancement Manuel — Guide Pas à Pas par OS

Si l'installation automatique échoue (dépendances Python manquantes, environnement corrompu, etc.), suivez ces étapes détaillées.

Prérequis communs - Node.js ≥ 20 et pnpm ≥ 8 disponibles dans le PATH - Python 3.12+ installé depuis python.org — sur Windows, évitez le Python du Microsoft Store, il cause fréquemment des soucis de PATH et de permissions - Git installé

Windows (PowerShell)

   cd WorkPilot-AI

   # Backend : créer et activer l'environnement virtuel
   python -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -r requirements.txt

   # Le backend a un SECOND venv indépendant sous apps/backend — voir
   # "Notes Spécifiques Windows" ci-dessous, il a besoin du même traitement pywin32
   cd apps\backend
   python -m venv .venv
   .venv\Scripts\python.exe -m pip install -r requirements.txt
   cd ..\..

   # Frontend
   cd apps\frontend
   pnpm install
   cd ..\..

   pnpm run dev
   

macOS / Linux (bash/zsh)

   cd WorkPilot-AI

   # Backend : créer et activer l'environnement virtuel
   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

   # Frontend
   cd apps/frontend
   pnpm install
   cd ../..

   pnpm run dev
   

4. Vérifier que le backend répond

   curl http://127.0.0.1:9000
   

Validation de l'Installation

#### Tests de Connexion ```bash

Quick Start

1. Download and install the app for your platform
2. Open your project — select a git repository folder
3. Connect your AI provider — Claude (OAuth), API key, or any OpenAI-compatible endpoint
4. Create a task — describe what you want to build
5. Watch it work — agents plan, code, and validate autonomously

Or from source:

pnpm install
pnpm run dev

See Installation et Configuration below for detailed instructions.

---

CLI Usage

For headless operation, CI/CD integration, or terminal-only workflows:

cd apps/backend
python runners/spec_runner.py --interactive   # Create a spec interactively
python run.py --spec 001                      # Run autonomous build
python run.py --spec 001 --review             # Review
python run.py --spec 001 --merge              # Merge

See docs/CLI-USAGE.md for the full CLI reference.

---

Venv racine

.\.venv\Scripts\python.exe -m pip install --upgrade "pywin32>=312" .\.venv\Scripts\python.exe .\.venv\Scripts\pywin32_postinstall.py -install .\.venv\Scripts\python.exe -c "import pywintypes; print('OK')"

Venv du backend

cd apps\backend .venv\Scripts\python.exe -m pip install --upgrade "pywin32>=312" .venv\Scripts\python.exe .venv\Scripts\pywin32_postinstall.py -install .venv\Scripts\python.exe -c "import pywintypes; print('OK')" cd ..\..

Les deux dernières commandes doivent chacune afficher `OK`. Si `import pywintypes` échoue encore après le postinstall (les DLL sont copiées mais le module reste introuvable — signe que le fichier `.pth` de pywin32 n'a pas été traité par l'interpréteur), n'insistez pas à patcher symptôme par symptôme : **supprimez et recréez ce venv à neuf**, c'est ce qui résout le problème de façon fiable :

Si le problème persiste même après une recréation complète du venv, c'est le signe d'une installation Python **de base** corrompue (pas seulement le venv) — voir **Dépannage Courant → Problèmes Python / venv**.

#### 2. `pnpm run dev` ouvre une seconde console élevée (UAC)

C'est voulu : voir `apps/frontend/scripts/dev-elevated.cjs`. WorkPilot AI relance tout le stack Electron en administrateur sur Windows, nécessaire pour une fonctionnalité de capture visuelle admin-only. Si vous n'avez pas besoin de cette fonctionnalité — ou si cette console élevée échoue à écrire `apps/frontend/.env-files/.env` (`PermissionError`) — désactivez l'élévation :

Si vous avez déjà lancé l'app une fois **avec** élévation avant de désactiver, le fichier `apps/frontend/.env-files/.env` peut rester marqué par le process administrateur qui l'a créé (visible via `Get-Acl` : propriétaire `BUILTIN\Administrateurs`) et bloquer toute écriture ultérieure par un process non-admin, même avec des permissions NTFS qui semblent correctes. Supprimez-le pour qu'il soit régénéré proprement :

#### 3. Smart App Control / Application Control bloque les binaires natifs npm

Si `pnpm run dev` plante sur `electron-vite dev` avec une erreur du type `Error: An Application Control policy has blocked this file` (souvent sur un fichier `.node` dans `node_modules`, par exemple un binding natif de `rolldown` ou un autre paquet compilé), c'est **Smart App Control** (Windows 11) ou une politique **WDAC** qui bloque le chargement d'un binaire natif fraîchement installé et non reconnu.

Vérifiez l'état :

⚠️ Cette désactivation est définitive sans réinstallation complète de Windows — c'est une limitation volontaire de Microsoft.

Sur un PC d'entreprise (politique WDAC imposée), il faudra faire autoriser les binaires natifs Node par votre IT plutôt que de désactiver quoi que ce soit vous-même.

4. PowerShell ≠ cmd.exe

Les commandes cmd.exe classiques (rmdir /s /q, rd, …) n'existent pas nativement en PowerShell et provoquent des erreurs ParameterBindingException confuses. Utilisez les équivalents PowerShell :

5. Une installation Python de base corrompue casse tout silencieusement

Si vous rencontrez ModuleNotFoundError: No module named 'pip', un avertissement Ignoring invalid distribution ~ip, ou si import pywintypes échoue systématiquement même après un postinstall qui semble réussi (DLL copiées, mais import introuvable), votre installation Python de base (pas le venv) est corrompue — généralement un reliquat de mise à jour pip interrompue. Les symptômes se propagent à tous les venvs créés à partir de cette installation. Solution : désinstallez complètement Python, réinstallez-le proprement depuis python.org (cochez "Add python.exe to PATH", évitez la version Microsoft Store), puis recréez tous les venvs du projet (racine et apps/backend).

Configuration des Providers AI

#### Authentification Claude (Recommandé) ```bash claude

.env-files/.env

AUTO_BUILD_MODEL=claude-opus-5 DEBUG=true LINEAR_API_KEY=votre_clé_linear GRAPHITI_ENABLED=true ```

Configuration du Projet

#### Structure de Projet Requise

votre-projet/
├── .git/                # Obligatoire : dépôt Git initialisé
├── package.json         # Pour projets Node.js
├── requirements.txt     # Pour projets Python
├── Cargo.toml           # Pour projets Rust
└── ...                  # Vos fichiers de code

#### Détection Automatique de Stack WorkPilot AI détecte automatiquement : - Framework : React, Vue, Angular, Django, Flask, Express - Language : TypeScript, JavaScript, Python, Rust, Go - Build Tools : Vite, Webpack, Cargo, Poetry - Testing : Jest, Pytest, Vitest, Playwright

Configuration Claude

claude --version ```

Interface

Autonomous Development Pipeline

Integrations