Démarrer ta première instance auto-hébergée

Démarre Tale localement avec la CLI publiée, puis crée ton espace de travail et envoie un message. Tu n’as pas besoin de cloner le dépôt, d’installer Bun ou de compiler l’application. La CLI télécharge les images des conteneurs et prépare la configuration.

Préparer la machine locale

Il te faut :

• macOS, Linux ou Windows avec PowerShell, ainsi que Docker Engine 24.0 ou une version ultérieure exécutant des conteneurs Linux avec Compose. Docker Desktop inclut Compose sur macOS et Windows. Si Docker manque, tale dev propose de t’aider à l’installer ; avec un moteur plus ancien, la commande s’arrête avant de télécharger la moindre image.
• Un accès réseau à GitHub pour la CLI et aux registres de conteneurs pour les images. Le premier démarrage télécharge plusieurs Go ; prévois de la place pour les images et tes données.
• Les identifiants d’un fournisseur de modèles compatible pour tester la première réponse. Tu peux créer ton compte et explorer l’application avant de connecter un fournisseur.

Sur ARM64, y compris Apple Silicon, le stockage objet fourni nécessite l’émulation amd64. Docker Desktop l’inclut ; sur un hôte Linux avec Docker autonome, tu dois la configurer séparément. Vérifie les prérequis d’architecture avant de démarrer sur ARM64 Linux.

Le port HTTPS par défaut est 443 ; le service sandbox utilise aussi 127.0.0.1:8003. Garde l’instance privée jusqu’à la création de son compte propriétaire.

Installer la CLI

Choisis l’installateur adapté à ton système :

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

Vérifie l’installation avec tale --version dans le même terminal. Si la commande est introuvable, suis les indications de l’installateur pour le PATH et rouvre les terminaux déjà ouverts. Le guide CLI couvre les versions fixées et le choix du répertoire d’installation.

Consulte tale --help avant d’utiliser tale doctor. Si doctor n’y figure pas, lance docker info et docker compose version pour vérifier Docker et Compose. Lorsqu’elle est disponible, la commande tale doctor examine aussi la version de Docker Engine, l’architecture des conteneurs et les ports locaux sans installer de logiciel ni modifier de fichiers. Suis les solutions proposées ; un résultat positif ne vérifie ni les téléchargements d’images ni l’accès aux modèles.

Initialiser et démarrer

Choisis où conserver ton projet, puis exécute :

tale init my-project
cd my-project
tale dev

tale init crée le projet et un fichier .env privé contenant les secrets générés. Sauvegarde ce fichier et ses clés de chiffrement en lieu sûr. À la question sur Docker dans les sandboxes, conserve le choix désactivé par défaut tant que tes agents n’ont pas besoin de Docker : son activation autorise Docker imbriqué avec privilèges.

tale dev démarre les conteneurs et affiche l’adresse lorsque l’application est prête. Laisse la commande tourner pendant les premiers téléchargements et la préparation de la base de données. Ouvre l’URL affichée, normalement https://localhost. Le certificat local est autosigné ; vérifie que l’adresse correspond à ta propre instance avant d’accepter l’avertissement du navigateur.

Créer le propriétaire et tester une réponse

1. Suis l’assistant pour créer ton compte et nommer l’organisation. Ce premier compte devient son Propriétaire. Premier compte propriétaire explique comment vérifier ce rôle et utiliser un compte existant.
2. Après la configuration, ouvre Paramètres > Fournisseurs IA et ajoute des identifiants compatibles. La dernière page de l’assistant mène aussi aux paramètres des fournisseurs. Consulte Fournisseurs IA pour les champs et les méthodes d’authentification prises en charge.
3. Ouvre Accueil, choisis Nouveau chat, sélectionne un modèle disponible et envoie une courte demande, par exemple « Écris une liste de trois points pour préparer une réunion. » Attends la fin de la réponse.

Une réponse complète confirme que le compte, le fournisseur et le modèle choisi fonctionnent ensemble. Si la liste des modèles est vide ou que la demande échoue, consulte les solutions du guide des fournisseurs. Envoyer ton premier message explique comment poursuivre et retrouver la conversation. Quand tu souhaites déléguer du travail dans un projet, crée ton premier agent.

Arrêter et reprendre plus tard

Appuie sur Ctrl-C dans le terminal qui exécute tale dev pour arrêter l’instance au premier plan. Relance tale dev depuis le même répertoire de projet pour reprendre avec les données existantes.

Consulte tale dev --help avant d’utiliser les commandes ci-dessous pour le fonctionnement en arrière-plan. Si --stop n’y figure pas, garde tale dev au premier plan et arrête-le avec Ctrl-C.

tale dev --detach
tale dev --stop

L’arrêt conserve le projet, les secrets et les données persistantes. Continue à utiliser le même répertoire ; créer un nouveau projet démarre une instance distincte.

Résoudre les problèmes de démarrage

Réessaie après avoir corrigé la cause signalée ; conserve .env et les volumes de données. Si le problème persiste, suis le guide de dépannage et indique la version de la CLI ainsi que l’erreur pertinente dans ta demande d’aide. Retire les identifiants des logs avant de les partager.

Préparer la production

tale deploy applique la configuration du projet sur l’hôte Docker choisi. Le développement et le déploiement utilisent des volumes distincts : le compte local, les chats et les fichiers téléversés ne sont pas transférés. Prépare DNS, TLS, sauvegardes et contrôles d’accès avant d’ajouter ton équipe.

Lis TLS et domaines, Sauvegardes et restauration et Renforcement. Si tu dois maintenir toi-même les définitions des services, utilise Exécuter ton propre Compose.