Aller au contenu

Installation

Un seul point d'entrée, ./installer/install.sh, depuis un clone du dépôt. Trois façons de le suivre, qui exécutent exactement le même parcours :

  • en terminal (par défaut) : menu des serveurs MCP à cocher, progression animée ;
  • --app : installeur graphique local, servi sur http://127.0.0.1:9877/ui/ ;
  • --headless : sans interface, chaque question prend sa valeur par défaut (machines sans terminal, essais en VM).

--demo simule tout le parcours sans exécuter une seule commande.

Démarrage rapide

git clone https://github.com/amineutron/lyra.git && cd lyra
./installer/install.sh

Le paquet Python seul (client, démon, règles, bancs) s'installe aussi depuis PyPI, sans les modèles ni les serveurs MCP : uv tool install lyra-assistant puis lyra --version (après publication ; en attendant : uv tool install git+https://github.com/amineutron/lyra). L'installeur reste le chemin complet.

L'installeur (TUI Rich interactif, ou --app pour une version graphique locale) détecte ta distro (Fedora/Debian/Arch), installe les dépendances système, crée le venv, télécharge Piper + une voix française, installe le client Ollama et pull deux modèles légers par défaut — qwen2.5-coder:0.5b (Apache-2.0) et llama3.2:1b (« Built with Llama », licence), environ 4 Go de VRAM au total. Les voix Piper et leurs licences sont listées dans VOICES.md. Ça tourne sans GPU dédié : --ollama-host <ip> pointe vers une machine distante qui héberge Ollama (validé le 2026-08-24 en conditions réelles sur 3 VMs Fedora, Ubuntu et Arch sans GPU : voir docs/user/VM_INSTALL_TESTS.md).

Aucune commande à copier-coller à la main pour les permissions sudo — l'installeur génère lui-même les règles sudoers pour ton utilisateur, pas un nom codé en dur.

Utilisation

lyra                          # mode texte interactif
lyra --vocal                  # mode vocal (STT/TTS)
lyra -p                       # mode performance (domotique sans confirmation)
lyra "demarre preprod-09"     # one-shot, sans interface
lyra -y "liste mes VMs"       # one-shot, confirmation auto

Garanties

  • Les secrets (credentials TV, pairing Hue username+clientkey) ne touchent jamais config.yaml (assert_no_secrets, teste).
  • config.yaml/secrets.yaml existants : backup horodate avant ecriture.
  • Le demon systemd lyra-daemon est installe et active (PATH avec .venv/bin en tete — piege documente dans CLAUDE.md).
  • Repos prives : pre-vol SSH GitHub, fallback https+PAT saisi a la volee (jamais ecrit sur disque).

Réseau d'entreprise, proxy ou machine sans Internet : voir Derrière un proxy, sans Internet.