Web

CodeTutor peut s’exécuter comme une application Web dans votre navigateur, offrant la même expérience puissante de codage d’IA sans avoir besoin d’un terminal.

Commencer

Démarrez l’interface Web en exécutant :

codetutor web

Cela démarre un serveur local sur 127.0.0.1 avec un port disponible aléatoire et ouvre automatiquement CodeTutor dans votre navigateur par défaut.

Attention

Si CODETUTOR_SERVER_PASSWORD n’est pas défini, le serveur ne sera pas sécurisé. C’est bien pour une utilisation locale mais doit être défini pour l’accès au réseau.

Windows Utilisateurs

Pour une expérience optimale, exécutez codetutor web à partir de WSL plutôt que de PowerShell. Cela garantit un accès correct au système de fichiers et une intégration du terminal.

---

Configuration

Vous pouvez configurer le serveur Web à l’aide d’indicateurs de ligne de commande ou dans votre fichier de configuration.

Port

Par défaut, CodeTutor sélectionne un port disponible. Vous pouvez spécifier un port :

codetutor web --port 4096

Nom d’hôte

Par défaut, le serveur se lie à 127.0.0.1 (localhost uniquement). Pour rendre CodeTutor accessible sur votre réseau :

codetutor web --hostname 0.0.0.0

Lorsque vous utilisez 0.0.0.0, CodeTutor affichera les adresses locales et réseau :

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

Découverte mDNS

Activez mDNS pour rendre votre serveur visible sur le réseau local :

codetutor web --mdns

Cela définit automatiquement le nom d’hôte sur 0.0.0.0 et annonce le serveur comme codetutor.local.

Vous pouvez personnaliser le nom de domaine mDNS pour exécuter plusieurs instances sur le même réseau :

codetutor web --mdns --mdns-domain myproject.local

CORS

Pour autoriser des domaines supplémentaires pour CORS (utile pour les frontends personnalisés) :

codetutor web --cors https://example.com

Authentification

Pour protéger l’accès, définissez un mot de passe à l’aide de la variable d’environnement CODETUTOR_SERVER_PASSWORD :

CODETUTOR_SERVER_PASSWORD=secret codetutor web

Le nom d’utilisateur par défaut est codetutor mais peut être modifié avec CODETUTOR_SERVER_USERNAME.

---

Utilisation de l’interface Web

Une fois démarrée, l’interface web permet d’accéder à vos sessions CodeTutor.

Sessions

Consultez et gérez vos sessions depuis la page d’accueil. Vous pouvez voir les sessions actives et en démarrer de nouvelles.

Statut du serveur

Cliquez sur “Voir les serveurs” pour afficher les serveurs connectés et leur état.

---

Attacher un terminal

Vous pouvez connecter un terminal TUI à un serveur Web en cours d’exécution :

# Start the web server
codetutor web --port 4096

# In another terminal, attach the TUI
codetutor attach http://localhost:4096

Cela vous permet d’utiliser simultanément l’interface Web et le terminal, en partageant les mêmes sessions et le même état.

---

Fichier de configuration

Vous pouvez également configurer les paramètres du serveur dans votre fichier de configuration codetutor.json :

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Les indicateurs de ligne de commande ont priorité sur les paramètres du fichier de configuration.