Aller au contenu

Installation depuis une archive

Tegvia peut être remis sous forme d'archive zip (tegvia-<nom>.zip), par exemple par votre administrateur. L'archive contient tout ce qu'il faut pour lancer Tegvia en mode autonome, en service en arrière-plan ou à la demande, ainsi que cette documentation sous forme de site prêt à ouvrir.

Ce que vous recevez

Fichier Rôle
tegvia-<nom>.zip L'archive elle-même.
tegvia-<nom>.zip.sha256 Son empreinte SHA-256, pour vérifier qu'elle n'a été ni abîmée ni modifiée en route.

Lire le nom de l'archive

<nom> est la version de Tegvia dont l'archive est issue :

Nom Signification
v1.2 La version publiée v1.2, exactement.
v1.2-3-gabc1234 Une compilation faite 3 commits après la version v1.2, depuis le commit commençant par abc1234. Ce n'est pas une version officielle.
abc1234 Aucune version publiée n'est connue : seul le hash du commit est disponible.
...-dirty La compilation incluait des modifications non encore commitées. Non reproductible : ne l'utilisez pas en production.
...-unaudited L'audit de sécurité des dépendances a été ignoré (voir le rapport de compilation).

Préférez les archives portant le nom d'une version simple (v1.2).

Vérifier l'archive

Placez le .zip et le fichier .zip.sha256 dans le même dossier, puis comparez l'empreinte.

Linux

sha256sum -c tegvia-<nom>.zip.sha256

macOS

shasum -a 256 -c tegvia-<nom>.zip.sha256

Windows (cmd.exe ou PowerShell)

certutil -hashfile tegvia-<nom>.zip SHA256

Sous Linux et macOS, la commande doit répondre OK. Sous Windows, comparez la valeur affichée avec celle du fichier .zip.sha256 (le texte avant le nom du fichier) : elles doivent être identiques. Si elles diffèrent, n'utilisez pas l'archive et demandez-en une nouvelle copie.

Extraire dans un dossier stable

Extrayez l'archive dans le dossier où Tegvia va rester, par exemple ~/tegvia ou C:\Tegvia. L'archive contient un seul dossier, tegvia-<nom>/. Le service en arrière-plan pointe vers ce dossier : si vous le déplacez ou le supprimez, le service ne fonctionne plus (relancez install après un déplacement).

Sous macOS, n'extrayez pas dans ~/Downloads, ~/Documents, ~/Desktop ni iCloud Drive (~/Library/Mobile Documents) : macOS restreint ce qu'un service en arrière-plan peut lire dans ces dossiers, si bien qu'un service installé depuis l'un d'eux peut ne jamais devenir actif. Utilisez plutôt un dossier comme ~/tegvia.

Dossier Sous macOS
~/Downloads/tegvia-<nom> Inadapté : l'installation affiche un avertissement
~/tegvia Adapté

Avant d'extraire, traitez les avertissements du système ci-dessous s'ils vous concernent.

macOS : Gatekeeper

Un fichier téléchargé depuis Internet est « en quarantaine ». Un double-clic sur launch/tegvia.command peut alors être refusé (« ne peut pas être ouvert car il provient d'un développeur non identifié »). La marche à suivre dépend de votre version de macOS :

  • macOS 15 (Sequoia) ou plus récent : le clic droit puis Ouvrir ne contourne plus le blocage. Essayez d'ouvrir le fichier une fois, puis allez dans Réglages Système, Confidentialité et sécurité, descendez jusqu'au message concernant tegvia.command et cliquez sur Ouvrir quand même, puis confirmez.
  • macOS 14 (Sonoma) ou plus ancien : faites un clic droit sur le fichier, choisissez Ouvrir, puis confirmez.
  • Toutes versions : retirez la quarantaine de tout le dossier extrait dans le Terminal. C'est le moyen le plus fiable :

    xattr -dr com.apple.quarantine <dossier extrait>
    

Lancer ./install.sh depuis le Terminal (l'installation recommandée) n'est pas bloqué par Gatekeeper ; cette section ne concerne que le double-clic sur launch/tegvia.command.

Windows : SmartScreen et marque « provenant d'Internet »

Windows marque un zip téléchargé, et ce qui en est extrait, comme provenant d'Internet. SmartScreen peut alors avertir à l'exécution de install.cmd ou launch\tegvia.cmd. Retirez la marque avant l'extraction : clic droit sur le zip, Propriétés, cochez Débloquer, OK. Ou, après extraction, dans PowerShell :

Get-ChildItem -Recurse <dossier extrait> | Unblock-File

Si SmartScreen affiche encore un avertissement, choisissez Informations complémentaires puis Exécuter quand même, à condition d'avoir vérifié l'empreinte.

Installer et lancer

Il faut Python 3.11 ou plus récent avec pip (voir Installation) et, au premier lancement, un accès réseau à PyPI : les dépendances sont téléchargées dans un dossier .deps/ à l'intérieur du dossier de Tegvia. Rien d'autre n'est installé.

Choisissez un mode, depuis le dossier extrait. Ne lancez pas le service et le lanceur en même temps (voir Déploiement autonome).

Mode Linux, WSL macOS Windows
Service en arrière-plan (démarre à la connexion) ./install.sh ./install.sh install.cmd
À la demande, lié à une fenêtre sh launch/tegvia.sh launch/tegvia.command launch\tegvia.cmd

Le service est la méthode recommandée, voir Service en arrière-plan. Sur un poste de bureau, il configure aussi l'icône de la zone de notification ; utilisez --no-tray pour l'éviter. L'archive contient l'icône et ses lanceurs (launch/tegvia-tray.sh, launch\tegvia-tray.cmd) ; sous Linux et macOS, l'icône a aussi besoin de requirements-tray.txt, sans lequel la construction de l'archive est refusée. Relancez ensuite Claude Code pour qu'il passe par le proxy.

La documentation est dans l'archive : ouvrez docs/index.html dans votre navigateur (elle fonctionne sans réseau, recherche comprise).

Expiration de la version d'évaluation

Une archive peut être une version d'évaluation avec une date de fin. La date est fixée à la compilation de l'archive (par défaut 180 jours après la date du commit dont elle est issue) et inscrite dans le LISEZMOI.txt de l'archive et dans build_report.txt (ligne expires ; none si l'archive n'a pas d'expiration). La commande status du service l'affiche aussi (Evaluation: expires <date> (in N days)).

Avertissements, pendant les 30 derniers jours.

  • La console web affiche un bandeau sur chaque écran.
  • L'icône de la zone de notification affiche une ligne d'information dans son menu et envoie une notification par jour.
  • Le proxy écrit une ligne WARNING dans son journal (proxy.stderr.log) à chaque démarrage.

À l'expiration. Le jour de la date est encore valide ; la version est refusée à partir du lendemain. Tegvia refuse alors de démarrer :

  • le lanceur autonome, les commandes install, start et restart du service et proxy.py --configure affichent le message ci-dessous et se terminent avec le code 78 (erreur de configuration : le service n'est pas relancé en boucle). proxy.py sans --configure refuse aussi de démarrer, mais il ne touche pas à settings.json et son message n'a pas la ligne « connexion directe » ;
  • quand il est lancé par le lanceur, le service ou --configure, Claude Code est remis en connexion directe à l'API Anthropic : Tegvia ne le protège plus. La redirection de ~/.claude/settings.json est retirée, et votre valeur précédente est rétablie s'il y en avait une. Si settings.json est illisible, invalide ou non modifiable, la redirection ne peut pas être retirée : le message n'a alors pas la ligne « connexion directe », et vous devez vérifier vous-même ~/.claude/settings.json (voir le dépannage) ;
  • install est refusé avant que quoi que ce soit soit installé (il retire quand même la redirection, comme ci-dessus). install --dry-run est refusé aussi, et ne modifie rien (il ne touche pas non plus à settings.json ; son message n'a pas la ligne « connexion directe ») ;
  • uninstall, stop et status fonctionnent toujours : vous pouvez toujours nettoyer.

Comportement du service à l'expiration : sous Linux (systemd), le code 78 signifie que le service n'est pas relancé. Sous macOS (launchd), le service se termine avec le code 0 : pas de boucle de relance. Sous Windows (Planificateur de tâches), la tâche est relancée jusqu'à 3 fois, en affichant le même message à chaque fois, sans autre effet.

Cette version d'évaluation de Tegvia a expiré le 2026-05-01, elle ne démarre donc pas.
Claude Code a été remis en connexion directe avec l'API Anthropic. Tegvia ne le protège plus.
Pour obtenir une nouvelle version, contacte : hello@tegvia.tech

Le message est en anglais par défaut, en français si TEGVIA_LANGUAGE=fr est défini dans l'environnement du lanceur (le proxy lui-même suit son réglage LANGUAGE). Si la date inscrite dans l'archive n'est pas valide, la version est considérée comme expirée et la première ligne le dit.

Obtenir une nouvelle version : contactez hello@tegvia.tech, puis suivez Mettre à jour.

Pour qui compile l'archive : build_dist.py --expires AAAA-MM-JJ fixe une autre date de fin (pas avant la date du commit), et --no-expiry compile une archive sans expiration (les deux sont incompatibles). Une référence antérieure à cette fonction se compile avec un avertissement et sans expiration.

La date est comparée à l'horloge de la machine : c'est un rappel pour mettre à jour, pas une protection contre la copie.

Mettre à jour

  1. Retirez le service de l'ancienne version : ./uninstall.sh (ou uninstall.cmd) depuis l'ancien dossier.
  2. Vérifiez et extrayez la nouvelle archive dans un dossier stable (un nouveau dossier, ou l'ancien une fois vidé).
  3. Lancez install.sh (ou install.cmd) depuis le nouveau dossier.

Vos journaux et réglages sont dans le dossier de données ~/.tegvia, hors du dossier de l'archive : ils sont conservés. Les dépendances sont réinstallées au premier lancement du nouveau dossier.

Désinstaller

  1. Lancez ./uninstall.sh (ou uninstall.cmd) : il retire le service et la redirection dans ~/.claude/settings.json.
  2. Supprimez le dossier extrait.

Pour effacer aussi vos journaux, supprimez le dossier de données ~/.tegvia (voir Désinstallation).

Le rapport de compilation

Le fichier build_report.txt, à la racine de l'archive, indique comment elle a été fabriquée. Ses lignes principales :

Ligne Signification
version Le nom de l'archive (voir plus haut).
ref La version publiée ou le commit dont elle est issue.
commit, commit_date Le commit exact.
dirty yes si elle incluait des modifications non commitées.
audit Résultat de l'audit de sécurité des dépendances : passed, ou skipped (archive nommée -unaudited).
dependencies, vulnerabilities, ignored Nombre de dépendances vérifiées, de vulnérabilités connues trouvées, et de vulnérabilités connues volontairement acceptées (listées sous [ignored] avec leur motif et leur date d'expiration).

Une archive n'est produite que si l'audit ne trouve aucune vulnérabilité non acceptée : vulnerabilities vaut donc 0 dans une archive livrée.

L'audit signale toutes les vulnérabilités connues. La compilation écarte ensuite celles que les mainteneurs ont acceptées dans audit-ignore.toml, chacune avec un motif et une date d'expiration : une vulnérabilité est acceptée lorsque son identifiant, ou l'un de ses alias (par exemple un numéro CVE), correspond à une entrée valide. Une entrée expirée ne protège plus rien et la compilation échoue.

Chaque fichier de l'archive porte la date du commit dont elle est issue, et non la date de la compilation.

Si une compilation est refusée (par exemple à cause de modifications non commitées sans --allow-dirty), le rapport écrit à côté a une version qui se termine par -dirty. Si la compilation ne peut pas écrire ses fichiers (disque plein, droit manquant), elle s'arrête avec un message d'erreur indiquant la cause et ne laisse aucune archive partielle.

Dépannage

  • macOS refuse d'ouvrir tegvia.command : voir Gatekeeper.
  • Windows affiche « Windows a protégé votre ordinateur » : voir SmartScreen.
  • Les fichiers ne s'exécutent pas après extraction sous Linux/macOS : utilisez sh install.sh (ou sh launch/tegvia.sh), ou extrayez avec unzip, qui conserve les droits d'exécution.
  • Le service ne démarre plus après un déplacement du dossier : relancez install depuis le nouvel emplacement. Voir Service en arrière-plan.
  • « no usable system Python 3.11+ found on PATH » ou « dependency install failed » : voir Dépannage.