Configuration Termux (Android)
Pi fonctionne sur Android via Termux, un émulateur de terminal et un environnement Linux pour Android.
Conditions préalables
- Installez Termux depuis GitHub ou F-Droid (pas Google Play, cette version est obsolète)
- 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
piPrise 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` accessLimites
- 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écuteztermux-setup-storageune fois pour accorder les autorisations
Dépannage
Le presse-papier ne fonctionne pas
Assurez-vous que les deux applications sont installées:
- Termux (depuis GitHub ou F-Droid)
- Termux: API (à partir de GitHub ou F-Droid)
Installez ensuite les outils CLI:
pkg install termux-apiAutorisation refusée pour le stockage partagé
Exécutez une fois pour accorder les autorisations de stockage:
termux-setup-storageNode.js problèmes d'installation
Si npm échoue, essayez de vider le cache:
npm cache clean --force