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 et fichiers d’agent sous `data/` ; espaces de travail des conversations (voir plus bas)
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é). Le répertoire de données y est data/, sauf si EYAS_DATA_DIR nomme un autre dossier — tout ce qui est sous data/ vit alors dans ce dossier :

Chemin	Contenu
`data/sqlite/`	Base SQLite principale (mode WAL, `synchronous = NORMAL`)
`data/vault/`	Coffre markdown sémantique / procédural — toujours `<répertoire de données>/vault`
`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

Les espaces de travail des conversations — le dossier dans lequel travaille chaque conversation sans dossiers propres — sont dans data/workspaces/ sur les installs Docker, Kubernetes et packagées. Une install depuis les sources lancée depuis un clone git les garde hors du checkout, dans le répertoire de données d’application de votre utilisateur. Voir Configuration — Espaces de travail des conversations.