Documentation CLI

1Vérifier Python

Le CLI PersoIA nécessite Python 3.9 ou supérieur. Vérifiez que Python est installé :

python --version

Python non installé ? Téléchargez-le surpython.org. Lors de l'installation, cochez impérativement "Add Python to PATH".

2Installer aider-chat

aider est l'assistant de code IA open-source utilisé par le CLI PersoIA. Il se connecte à votre instance GPU dédiée.

Installation via PowerShell (recommandé) :

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Ou via pip si vous préférez :

pip install aider-chat

3Installer le CLI PersoIA

Téléchargez et installez le CLI PersoIA. Vous pouvez également récupérer le script directement depuis le portail survotre espace client.

Télécharger et utiliser directement :

# Télécharger le script dans le dossier courant
curl -sL https://www.persoia.com/cli/persoia.py -o persoia.py

# Lancer directement
python persoia.py help

Pour un accès global (PowerShell) :

# Créer le dossier et y placer le script
New-Item -ItemType Directory -Force -Path "$env:APPDATA\persoia\bin"
curl -sL https://www.persoia.com/cli/persoia.py -o "$env:APPDATA\persoia\bin\persoia.py"

# Créer un raccourci .bat
Set-Content "$env:APPDATA\persoia\bin\persoia.bat" "@python `"$env:APPDATA\persoia\bin\persoia.py`" %*"

# Ajouter au PATH (redémarrez PowerShell après)
$p = [Environment]::GetEnvironmentVariable("PATH","User")
[Environment]::SetEnvironmentVariable("PATH","$p;$env:APPDATA\persoia\bin","User")

4Configurer la clé API

Connexion interactive (recommandé)

Utilisez persoia login pour vous authentifier. La clé est générée et sauvegardée automatiquement.

python persoia.py login
# ou, si installé globalement :
persoia login

Configuration manuelle

Créez votre clé API depuis le portailvotre espace client, puis configurez-la manuellement :

# Créer le dossier de configuration
New-Item -ItemType Directory -Force -Path "$env:APPDATA\persoia"

# Enregistrer la clé API
Set-Content "$env:APPDATA\persoia\config.env" "PERSOIA_API_KEY=votre_clé_ici"

Vérifier la configuration :

persoia config

5Utiliser le CLI

Coder avec l'IA

Lancez une session de code assistée par IA dans votre projet. Le CLI ouvre aider, connecté à votre instance GPU PersoIA.

# Se placer dans son projet, puis lancer
cd mon-projet/
persoia code

# Avec des options aider supplémentaires
persoia code --no-auto-commits

Question rapide

Posez une question ponctuelle sans ouvrir de session interactive.

persoia chat "Explique ce Dockerfile"
persoia chat "Optimise cette fonction Python"

Référence des commandes

Commande	Description
persoia code	Lance une session de code IA avec aider
persoia code --no-auto-commits	Session de code sans commits automatiques
persoia chat "question"	Question rapide, réponse immédiate
persoia config	Affiche la configuration active
persoia login	Connexion interactive (email + mot de passe)
persoia logout	Déconnexion (supprime la clé API locale)
persoia help	Affiche l'aide

Fichier PERSOIA.md

Créez un fichier PERSOIA.md à la racine de votre projet pour donner du contexte à l'IA sur votre base de code. Ce fichier est automatiquement injecté dans chaque session.

# PERSOIA.md — exemple

# Mon Projet

## Stack technique
- Backend : Django 5 + PostgreSQL
- Frontend : Vue 3 + Vite
- Tests : pytest + Vitest

## Conventions
- Code en anglais, commits conventionnels
- Tests obligatoires pour tout nouveau code
- Pas de console.log en production

L'IA utilisera ces instructions pour générer du code adapté à vos conventions et votre architecture.

Fonctionnement

Le CLI PersoIA connecte aider à votre instance GPU dédiée. Toutes les requêtes transitent par l'API PersoIA qui gère l'authentification, l'audit et la facturation.

Votre terminal

persoia code

API PersoIA

Auth, audit, facturation

Votre GPU dédié

Instance privée, France

🔒

Chiffrement bout en bout

HTTPS/TLS sur toute la chaîne

🇫🇷

Infrastructure française

OVH / Scaleway, conforme RGPD

🛡️

Données isolées

Aucun partage entre clients