Install
nac-web upgradeÀ qui s'adresse nac
- Aux utilisateurs qui veulent confier de grandes tâches de longue durée à un agent IA sans craindre de le voir échapper à tout contrôle : nac est un framework d'exécution d'agents open source développé par Arcee, fondé sur une architecture thread-and-episode (fils et épisodes) — un orchestrateur central se charge de planifier et de décomposer le travail, mais il ne peut ni exécuter de commandes ni modifier des fichiers ; il ne peut que lancer des fils. À la fin de chaque fil, un « episode » est renvoyé, c'est-à-dire un résumé structuré du travail qui vous indique précisément ce qui a été fait.
- Aux utilisateurs qui utilisent déjà d'autres outils d'agents (harness) et souhaitent intégrer nac : d'après la description officielle, nac fournit un onboarding skill portable et une intégration MCP ; il suffit de coller le fragment d'intégration officiel dans l'outil d'agent de votre choix pour installer nac, terminer la configuration et connecter MCP.
- Il ne convient pas à un usage direct comme exécuteur en ligne de commande : l'orchestrateur ne peut pas exécuter de commandes ni modifier de fichiers à votre place ; toute exécution se produit dans les fils lancés.
- Les sources ne précisent pas la liste exacte des clients d'agents pris en charge, la compatibilité des plateformes ni les ressources requises : ces points restent inconnus.
Première tentative en 3 minutes
Chemin principal recommandé : installateur officiel → connexion par code d'appareil → tableau de bord local.
- Prérequis : les sources ne précisent ni les dépendances préalables ni la commande d'installation reproductible ; reportez-vous aux instructions d'installation du README officiel. Une fois l'installation terminée,
nac-webest placé par l'installateur dans$HOME/.local/bin; ajoutez ce répertoire auPATHsi nécessaire. - Choisissez l'authentification du modèle — c'est une étape obligatoire avant de démarrer une session (elle peut aussi être effectuée plus tard dans le tableau de bord). Le chemin recommandé officiellement est la connexion par code d'appareil Arcee, qui donne accès aux modèles Latest Open et Arcee Trinity :
nac-web arcee-auth login
- Lancez le tableau de bord depuis votre répertoire de projet. Signal de réussite : le tableau de bord est accessible, l'authentification est terminée et vous pouvez choisir un modèle.
Mises à jour ultérieures : nac dispose d'une fonction de mise à niveau native permettant d'installer la dernière version stable :
nac-web upgrade
Méthodes d'authentification alternatives (mention secondaire uniquement) : nac-web codex-auth login permet d'obtenir les modèles OpenAI via OAuth avec un compte ChatGPT ; ou exportez une clé API d'un fournisseur de catalogue (par exemple OPENAI_API_KEY). Attention : la connexion implique vos identifiants de compte ; l'authentification du modèle doit être choisie avant de démarrer une session. Pour la première tentative, lancez une seule tâche à faible risque et au résultat observable, en privilégiant les actions en lecture seule ; le travail décrit dans l'episode est exécuté par les fils, et une tâche réelle peut inclure des opérations d'écriture — une étape de confirmation devrait précéder tout effet de bord important.
Cas d'usage
-
Déléguer une tâche de longue durée et récupérer un résultat structuré : dans le tableau de bord local, démarrez une session avec un modèle authentifié (de préférence Latest Open ou Arcee Trinity après connexion par code d'appareil Arcee) et lancez une tâche. L'orchestrateur décompose le travail et lance des fils ; à la fin de chaque fil, un episode est renvoyé — un résumé structuré indiquant ce qui a été accompli. Résultat attendu : vous n'avez pas besoin de surveiller l'ensemble du processus, l'episode vous informe des résultats de chaque segment de travail.
-
Intégrer nac à vos outils d'agents existants : le projet fournit officiellement un onboarding skill portable et une intégration MCP ; collez le fragment d'intégration officiel dans l'outil d'agent de votre choix pour installer nac, terminer la configuration et connecter MCP. Les sources ne fournissent pas de détails pas à pas pour des clients d'agents précis ; le comportement concret avec votre agent devra être vérifié à l'usage — ce qui est confirmé, c'est cette capacité d'intégration fournie officiellement.
Limites d'utilisation
- Nature lecture/écriture : l'orchestrateur lui-même se contente de planifier et de lancer des fils, sans exécuter de commandes ni modifier de fichiers ; l'exécution réelle se produit dans les fils, de sorte qu'une tâche réelle peut inclure des opérations d'écriture et des exécutions de commandes — pour la première tentative, commencez par une tâche au résultat observable, et prévoyez une étape de confirmation avant tout effet de bord important.
- Exigences d'authentification : l'authentification du modèle doit être terminée avant de démarrer une session (connexion par code d'appareil recommandée via
nac-web arcee-auth login; ounac-web codex-auth login; ou export d'une clé API d'un fournisseur de catalogue telle queOPENAI_API_KEY). Les sources ne précisent pas s'il existe un quota gratuit ou une facturation : cela reste inconnu. - Composants locaux :
nac-webest placé par l'installateur dans$HOME/.local/bin, et le tableau de bord s'exécute localement, ce qui constitue une écriture d'état local ; les sources ne fournissent aucune procédure de désinstallation. - Limitation officielle explicite : l'orchestrateur ne peut ni exécuter de commandes ni modifier de fichiers ; il ne peut obtenir des résultats que sous forme d'episodes structurés via les fils.
- Informations clés non confirmées : les clients d'agents précisément pris en charge, les coûts et quotas des appels de modèles, l'isolation environnementale et les limites de permissions de l'exécution des fils, ainsi que la commande d'installation exacte et le nom de l'onboarding skill portable ne sont mentionnés nulle part dans les sources officielles ; avant d'entreprendre des tâches à haut risque, vérifiez ces points dans la documentation ou le dépôt officiel, et ne déduisez pas d'une « absence d'information » qu'il n'y a « aucun risque ».