Installation & Configuration

📋 Prérequis Système

Système d'exploitation

• macOS 11.0+ (Big Sur ou supérieur)
• Linux (Ubuntu 20.04+, Fedora 35+, Arch Linux)
• Windows 10/11 (64-bit)

Configuration minimale

• RAM: 4 GB minimum, 8 GB recommandé
• Stockage: 500 MB pour l'application, 2 GB recommandé pour les projets
• Processeur: Intel Core i5 / AMD Ryzen 5 ou équivalent

Configuration recommandée (avec GPU)

• GPU: Compatible Metal (macOS M1+/Intel Iris+) ou CUDA (NVIDIA GTX 1060+)
• RAM: 16 GB+
• VRAM: 4 GB+ (pour l'accélération GPU optimale)

Dépendances

• Claude CLI — Requis (sera installé automatiquement si absent)
• Node.js 18+ — Pour les projets TypeScript/JavaScript
• Git — Pour les opérations de versioning

📦 Installation

macOS

# Via Homebrew (recommandé)
brew install francois

# Ou téléchargement direct
curl -fsSL https://francois.dev/install.sh | sh

Linux

# Ubuntu/Debian
sudo apt update
sudo apt install francois

# Fedora
sudo dnf install francois

# Arch Linux
yay -S francois

# Ou script universel
curl -fsSL https://francois.dev/install.sh | sh

Windows

# Via winget
winget install Francois.Francois

# Ou téléchargement .exe
# https://github.com/MattJeff/FrancoisbuyClaude/releases

🔧 Configuration Initiale

1. Clé API Claude

François nécessite une clé API Anthropic pour fonctionner. Obtenez-en une sur console.anthropic.com.

# Configurer la clé API
francois config set ANTHROPIC_API_KEY=sk-ant-xxxxx

# Ou via variable d'environnement
export ANTHROPIC_API_KEY=sk-ant-xxxxx

2. Choix du modèle par défaut

# Sonnet (équilibre perf/coût, recommandé)
francois config set DEFAULT_MODEL=claude-sonnet-4-5

# Opus (qualité maximale, plus coûteux)
francois config set DEFAULT_MODEL=claude-opus-4

# Haiku (vitesse maximale, économique)
francois config set DEFAULT_MODEL=claude-haiku-4

3. Activation GPU (optionnel)

# Vérifier si le GPU est détecté
francois gpu status

# Activer l'accélération GPU
francois config set GPU_ENABLED=true

# Choix du backend
francois config set GPU_BACKEND=metal  # macOS
francois config set GPU_BACKEND=cuda   # Linux/Windows NVIDIA
francois config set GPU_BACKEND=vulkan # Fallback universel

🚀 Premier Projet

1. Créer un nouveau projet

# Créer et ouvrir un projet
francois new mon-projet
cd mon-projet
francois open

2. Ou ouvrir un projet existant

# Ouvrir le dossier actuel
francois open .

# Ouvrir un chemin spécifique
francois open /path/to/project

3. Première conversation

L'interface François s'ouvre. Essayez :

• "Crée une API REST en TypeScript avec Express"
• "Ajoute des tests unitaires avec Jest"
• "Explique-moi l'architecture de ce projet"

⚙️ Configuration Avancée

Autopilot

# Activer/désactiver l'Autopilot
francois config set AUTOPILOT_ENABLED=true

# Configurer les agents
francois config set AUTOPILOT_ANALYST_MODEL=sonnet
francois config set AUTOPILOT_ARCHITECT_MODEL=opus
francois config set AUTOPILOT_CODER_MODEL=sonnet

Observer

# Activer François Observer
francois config set OBSERVER_ENABLED=true

# Configurer la rétention des événements
francois config set OBSERVER_TIMELINE_RETENTION=24h

# Configurer les alertes
francois config set OBSERVER_HEALTH_THRESHOLD=50

Voice Control

# Activer le contrôle vocal
francois config set VOICE_ENABLED=true

# Choisir la langue
francois config set VOICE_LANGUAGE=fr-FR  # Français
francois config set VOICE_LANGUAGE=en-US  # Anglais US

🔍 Vérification de l'installation

# Afficher la configuration actuelle
francois config list

# Tester l'API Claude
francois test api

# Tester le GPU (si activé)
francois test gpu

# Vérifier la santé globale
francois health

🆘 Problèmes Courants

Erreur "Claude CLI not found"

# Installer Claude CLI manuellement
npm install -g @anthropic-ai/claude-cli

# Puis redémarrer François
francois restart

GPU non détecté

# Vérifier les drivers
# macOS : Pas de drivers nécessaires (Metal natif)
# Linux NVIDIA : installer nvidia-cuda-toolkit
# Windows NVIDIA : installer CUDA Toolkit 12.0+

# Forcer la réinitialisation GPU
francois gpu reinit

Performances lentes

• Vérifier que le GPU est activé : francois gpu status
• Essayer un modèle plus rapide : francois config set DEFAULT_MODEL=haiku
• Réduire la taille du contexte : francois config set MAX_CONTEXT_SIZE=100000