Installation

Crew est distribué sous forme de paquet Python qui regroupe le tableau de bord React. Il existe quatre façons de l'installer; choisissez celle qui convient le mieux à votre façon de l'exécuter. Toutes les versions sont construites avec de simples pip + npm/Vite + pytest. Aucun outillage propriétaire.

Crew fait fonctionner un LLM par l'intermédiaire de kiro-cli via le Agent Client Protocol. C'est le seul fournisseur (agent.provider = acp). Le tableau de bord guide la configuration et la connexion de Kiro CLI avant l'ouverture du clavardage. kirocrew doctor indique si le binaire est trouvé et si la connexion est établie.

Si le Gateway détecte une Kiro CLI sans la commande acp requise, la configuration s'arrête à Mise à jour de Kiro CLI requise. Sélectionnez Mettre à jour Kiro CLI pour exécuter kiro-cli update sur l'hôte Gateway, puis relancez la vérification.

La mémoire sémantique ne nécessite aucune configuration. Les plongements s'exécutent dans le même processus et le Gateway télécharge son modèle de plongement (~610 Mo) en arrière-plan au premier démarrage, le vérifie et le stocke sous ~/.kiro/crew/models. Jusqu'à ce que le modèle soit en place, la recherche en mémoire se replie sur la correspondance par mots-clés et adopte automatiquement les plongements sans redémarrage. Définissez KIROCREW_EMBED_MODEL_URL pour pointer vers un miroir pour les installations en réseau isolé.

Crew prend en charge Windows nativement. Utilisez CPython 3.12 + un venv + pip install -e . tzdata, puis lancez avec python -m kiro_crew gateway.

py -3.12 -m venv .venv
.venv\Scripts\activate
pip install -e . tzdata
python -m kiro_crew gateway

Tous les appels de processus, de signal, de verrouillage de fichier et de mesures propres à POSIX passent par kiro_crew.platform_compat. Le bac à sable de système de fichiers au niveau du système d'exploitation (espaces de noms Linux / Seatbelt macOS) n'est pas disponible sur Windows; toutes les autres fonctionnalités fonctionnent, et Computer Use pilote les applications Windows natives par l'intermédiaire de UI Automation. Le terminal Web interactif et le PTY de connexion SSO se replient sur une réponse claire « non pris en charge sur Windows » plutôt que de planter.

Le programme d'installation Windows signé se met à jour sur place : Restart & Update affiche la progression de l'installation, met à jour l'installation existante, réassocie les raccourcis conservés du menu Démarrer et du bureau, puis relance la nouvelle version. Les versions antérieures imbriquaient une copie et rouvraient l'ancienne; ce comportement a disparu.

Pour les installations par wheel et cli.sh, kirocrew update installe la nouvelle version dans une arborescence fraîche dont la signature est vérifiée et y bascule de façon atomique. Vous n'avez pas besoin de réexécuter manuellement le programme d'installation.

kirocrew update

La page Paramètres → À propos indique la date de la dernière vérification de mise à jour et de la prochaine, affiche la version réellement en cours d'exécution et présente les notes « Nouveautés » de la version que vous venez d'installer, et non d'une version antérieure.

Lorsque Crew modifie une valeur par défaut entre deux versions, votre configuration enregistrée peut encore conserver l'ancienne valeur par défaut. Exécutez kirocrew config defaults pour répertorier les valeurs enregistrées qui utilisent toujours des valeurs par défaut remplacées. Utilisez --adopt pour adopter les valeurs par défaut actuelles ou --keep pour enregistrer les valeurs stockées comme intentionnelles.

Cela s'applique après une mise à niveau, particulièrement si le modèle vocal stt_model ou les paramètres de bac à sable ont été définis par une version antérieure.

Pour les installations par wheel en une seule ligne, à partir des sources et Docker, configurez et vérifiez après l'installation :

kirocrew setup            # interactive wizard: data dir, agent, credentials
kirocrew doctor           # verify everything is wired up
kirocrew gateway          # start the server → http://localhost:5476

kirocrew doctor indique l'état du binaire kiro-cli, son authentification, Ollama/plongements, les jetons Slack, la validité de la configuration et les serveurs MCP.

Tout l'état persistant se trouve sous ~/.kiro/crew/ (à remplacer par KIROCREW_HOME) :

~/.kiro/crew/
├── config.json          # user configuration
├── .env                 # Slack tokens, owner ID, other credentials
├── workspace/
│   ├── memory/          # preferences.md, projects.md, history/
│   ├── lessons.jsonl    # learned corrections
│   └── knowledge/       # ingested documents (FTS5 + vectors)
├── conversations/       # JSONL session logs
├── crons.json           # scheduled jobs
├── audit.log            # bash command audit trail
└── agents/              # generated kiro-cli agent configs

KIROCREW_HOME et KIROCREW_PORT sont tous deux validés à l'entrée de la CLI, et non stockés comme clés de configuration. Passez --port sur la CLI pour remplacer la variable d'environnement à chaque invocation.

Installez avec pip install "kirocrew[<extra>]" :

Piper TTS est le fournisseur de synthèse vocale par défaut et s'exécute localement — aucune installation supplémentaire n'est nécessaire.