Démarrage rapide auto-hébergé

C'est le chemin le plus rapide vers un Tale qui tourne : installe la CLI tale, puis deux commandes. Le résultat est ta propre organisation qui tourne sur ta propre machine, joignable dans le navigateur. C'est pensé pour un laptop ou un hôte unique sur lequel tu veux essayer Tale ; quand tu es prêt à le faire tourner pour de vrai, le parcours Linux serveur couvre une installation de production durcie.

Il te faut une chose pour démarrer, et une chose avant qu'un agent puisse répondre :

• Docker Desktop (v24+) en marche, ou Docker Engine plus le plugin Compose sous Linux. C'est le seul prérequis pour faire monter la stack.
• Une clé API OpenRouter (ou n'importe quel fournisseur compatible OpenAI) pour que les agents aient un modèle à qui parler. Tu n'en as pas besoin pour tale init — tu l'ajoutes dans l'app après l'inscription, dans l'assistant de configuration ou sous Paramètres > Providers, et tu pourras brancher n'importe quel fournisseur plus tard.

Étape 1 — Installer la CLI

Sous macOS ou Linux :

curl -fsSL https://raw.githubusercontent.com/tale-project/tale/main/scripts/install-cli.sh | bash

Sous Windows (PowerShell) :

irm https://raw.githubusercontent.com/tale-project/tale/main/scripts/install-cli.ps1 | iex

L'installateur détecte ton OS, dépose le binaire tale sur ton PATH, et c'est la seule étape qui touche ton système. Confirme qu'il a atterri :

tale --version

Étape 2 — Créer un projet

tale init my-project
cd my-project

tale init échafaude un répertoire de projet et pose une seule question — essai local ou domaine de production — puis génère chaque secret de sécurité pour toi et écrit le .env, de sorte qu'il n'y a rien à éditer à la main. Il ne demande pas de clé API ; celle-ci est collectée dans l'app une fois que tu es connecté. Il dépose aussi des agents, workflows et intégrations d'exemple sous default/, et génère la configuration d'éditeur pour Claude Code, Cursor, Copilot et Windsurf afin qu'un éditeur IA puisse construire des configurations en pleine connaissance du schéma.

Étape 3 — Démarrer Tale

tale dev

Le premier passage récupère les images et construit le graphe de conteneurs — compte cinq à dix minutes sur une machine neuve. Dès que la plateforme se signale prête (Tale Platform is running), tale dev ouvre ton navigateur automatiquement. S'il ne peut pas, il imprime l'URL à visiter.

Ton navigateur affiche un avertissement de certificat pour le certificat auto-signé local. C'est attendu — accepte-le pour continuer.

Ta configuration sous default/ est montée dans l'instance en marche, donc les édits aux agents, workflows et intégrations rechargent à chaud. Arrête la stack avec Ctrl-C (ou tale dev --detach pour la faire tourner en arrière-plan).

Étape 4 — Créer ton compte

Sur l'écran de connexion, clique Sign up et remplis tes nom, e-mail et mot de passe. Le premier compte sur une instance toute neuve revendique le rôle Owner et crée ton Organisation. Tu atterris dans le dashboard.

Si l'écran d'inscription demande une clé admin à usage unique, Premier admin est la courte marche qui l'imprime et explique comment fermer l'inscription une fois ton équipe entrée.

Étape 5 — Ajouter un modèle et publier un agent

Tu as maintenant une organisation vide. Deux gestes t'amènent à quelque chose d'utile :

1. Ajoute ta clé OpenRouter. L'assistant de configuration la demande juste après la création du compte owner ; si tu l'as sautée, ouvre Paramètres > Providers et colle-la là. Une coche sur la ligne du fournisseur signifie que la clé marche.
2. Publie ton premier agent — Créer un agent le mène d'un rôle et de quelques instructions à un spécialiste fonctionnel.

À partir de là, la doc Platform est la référence canonique pour chaque fonctionnalité, et elle est identique à Cloud.

Plutôt du Docker Compose brut ?

La CLI enveloppe docker compose pour que tu n'aies pas à le faire. Si tu préfères faire tourner la stack depuis un clone du dépôt et gérer Compose toi-même — pour la transparence, des builds air-gapped ou ta propre automation — clone le dépôt, copie .env.example vers .env, règle HOST et SITE_URL, génère les secrets et docker compose up -d. Le parcours Linux serveur et la référence Docker Compose couvrent ce chemin de bout en bout.

Dépannage

• tale introuvable après l'installation. L'installateur nomme le répertoire de destination dans sa sortie ; assure-toi que ce répertoire est sur ton PATH (sous Linux, c'est généralement /usr/local/bin).
• tale dev se termine sur un conflit de port. Un autre service lie déjà 443 sur l'hôte. Libère-le, ou démarre sur un autre port avec tale dev --port 8443.
• Docker ne tourne pas. tale dev a besoin du démon Docker en route. Démarre Docker Desktop (ou sudo systemctl start docker sous Linux) et réessaie.
• Un conteneur crash-loope au premier démarrage. Presque toujours un secret manquant — relance tale dev, qui relance la configuration d'environnement, ou inspecte les logs avec tale logs platform.

Où ça s'utilise

Tu as maintenant une instance Tale qui marche sur ta machine. Pour la faire tourner pour de vrai, le parcours Linux serveur couvre TLS, pare-feu, un utilisateur non-root et les crochets opérationnels que tu veux avant que le vrai trafic n'arrive ; Installation de la CLI configure la CLI pour déployer et mettre à jour une instance distante depuis ta workstation.