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 premier lancement de l'application de bureau ou du tableau de bord peut installer Kiro CLI sur l'hôte Gateway et guider la connexion par code d'appareil avant l'ouverture du clavardage. kirocrew doctor indique si le binaire est trouvé et si la connexion est établie.

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 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. 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.

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.