Premiers pas

À quoi ça sert. Vous installez le serveur EYAS pour que l’interface web existe sur votre machine. Cette page est le chemin d’installation, pas une visite du produit.

Quand vous avez terminé, passez à l’assistant de configuration, puis à Votre première heure.

Ce que vous allez faire

Installer EYAS (natif ou Docker)
Démarrer le serveur
Terminer l’assistant de configuration
Ouvrir l’interface web et commencer à travailler — ensuite : Votre première heure

Prérequis

Exigence	Remarques
Bun 1.x (recommandé) ou Node.js 22+	L’environnement d’exécution principal est Bun
Espace disque	Base SQLite, coffre, espaces de travail des agents sous `data/`
Facultatif : Docker / Compose	Déploiement en conteneur
Facultatif : CLI de l’hôte	`claude`, `grok` ou `kimi` si vous voulez des fournisseurs locaux sans clé

Installation native

git clone https://github.com/eyssen/eyas.git
cd eyas
bun install
./bin/eyas start

Ouvrez http://localhost:3100 (port par défaut de config/default.yaml — 3100, pas 3000).

Premier plan (journaux dans le terminal) :

./bin/eyas serve

Installateur en une ligne

curl -fsSL https://raw.githubusercontent.com/eyssen/eyas/main/scripts/install.sh | bash

Non interactif : ajoutez bash -s -- --yes. Épingler une version : --version 0.8.16-beta.

Windows : scripts/install.ps1.

Docker

git clone https://github.com/eyssen/eyas.git
cd eyas
docker compose up -d

Ouvrez http://localhost:3100. GPU + Ollama en option :

docker compose --profile gpu up -d

Commandes de cycle de vie

Commande	Rôle
`eyas serve`	Serveur HTTP au premier plan
`eyas start`	Serveur en arrière-plan (fichier pid + journal)
`eyas stop`	Arrêter le processus d’arrière-plan
`eyas restart`	Arrêter puis démarrer
`eyas status`	Santé + PID
`eyas doctor`	Diagnostic de l’environnement local
`eyas version`	Chaîne de version

Au démarrage, EYAS reconstruit automatiquement le frontend et la documentation produit s’ils manquent ou sont obsolètes (bun run build:web, bun run docs:build), sauf si vous définissez EYAS_SKIP_WEB_BUILD=1 / EYAS_SKIP_DOCS_BUILD=1.

Premier accès

Étape	Résultat
Navigateur → `/setup` (automatique si la configuration est incomplète)	Assistant de configuration
Après la configuration	Connexion avec le compte propriétaire racine que vous avez créé
Accueil	Accueil
Documentation produit	Toujours à `/docs/` sur le même hôte/port

Où se trouvent les données

Sous le répertoire d’instance (EYAS_HOME ou le répertoire depuis lequel vous avez démarré) :

Chemin	Contenu
`data/sqlite/`	Base SQLite principale (mode WAL)
`data/vault/`	Coffre markdown sémantique / procédural
`data/agents/<id>/`	Fichiers d’espace de travail par agent (IDENTITY, SOUL, …)
`data/backups/`	Archives de sauvegarde
`config/`	Valeurs YAML par défaut + surcharges locales