Configuration, personnalisation, paramètres de plateforme et références API pour Pi.

Configuration Termux (Android)

Pi fonctionne sur Android via Termux, un émulateur de terminal et un environnement Linux pour Android.

Conditions préalables

  1. Installez Termux depuis GitHub ou F-Droid (pas Google Play, cette version est obsolète)
  2. Installez Termux:API depuis GitHub ou F-Droid pour le presse-papiers et d'autres intégrations de périphériques

Installation

# Update packages
pkg update && pkg upgrade

# Install dependencies
pkg install nodejs termux-api git

# Install pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Create config directory
mkdir -p ~/.pi/agent

# Run pi
pi

Prise en charge du presse-papiers

Les opérations du Presse-papiers utilisent termux-clipboard-set et termux-clipboard-get lorsqu'elles sont exécutées dans Termux. L'application Termux:API doit être installée pour que celles-ci fonctionnent.

Le presse-papiers d'images n'est pas pris en charge sur Termux (la fonction de collage d'image ctrl+v ne fonctionnera pas).

Exemple AGENTS.md pour Termux

Créez ~/.pi/agent/AGENTS.md pour aider l'agent à comprendre l'environnement Termux:

# Agent Environment: Termux on Android

## Location
- **OS**: Android (Termux terminal emulator)
- **Home**: `/data/data/com.termux/files/home`
- **Prefix**: `/data/data/com.termux/files/usr`
- **Shared storage**: `/storage/emulated/0` (Downloads, Documents, etc.)

## Opening URLs
```bash
termux-open-url "https://exemple.com"
```

## Opening Files
```bash
termux-open file.pdf # S'ouvre avec l'application par défaut
termux-open --chooser image.jpg # Choisir l'application
```

## Clipboard
```bash
termux-clipboard-set "texte" # Copier
termux-clipboard-get # Coller
```

## Notifications
```bash
termux-notification -t "Titre" -c "Contenu"
```

## Device Info
```bash
termux-battery-status # Informations sur la batterie
termux-wifi-connectioninfo # Informations WiFi
termux-telephony-deviceinfo # Informations sur l'appareil
```

## Sharing
```bash
termux-share -a send file.txt # Partager le fichier
```

## Other Useful Commands
```bash
termux-toast "message" # Popup rapide de toast
termux-vibrate # Appareil vibrant
termux-tts-speak "bonjour" # Synthèse vocale
termux-camera-photo out.jpg # Prendre une photo
```

## Notes
- Termux:API app must be installed for `termux-*` commands
- Use `pkg install termux-api` for the command-line tools
- Storage permission needed for `/storage/emulated/0` access

Limites

  • Pas de presse-papiers d'images: Termux le presse-papiers API ne prend en charge que le texte
  • Aucun binaire natif: certaines dépendances natives facultatives (comme le module presse-papiers) ne sont pas disponibles sur Android ARM64 et sont ignorées lors de l'installation.
  • Accès au stockage: pour accéder aux fichiers dans /storage/emulated/0 (téléchargements, etc.), exécutez termux-setup-storage une fois pour accorder les autorisations

Dépannage

Le presse-papier ne fonctionne pas

Assurez-vous que les deux applications sont installées:

  1. Termux (depuis GitHub ou F-Droid)
  2. Termux: API (à partir de GitHub ou F-Droid)

Installez ensuite les outils CLI:

pkg install termux-api

Autorisation refusée pour le stockage partagé

Exécutez une fois pour accorder les autorisations de stockage:

termux-setup-storage

Node.js problèmes d'installation

Si npm échoue, essayez de vider le cache:

npm cache clean --force