[English](../README.md) · [العربية](README.ar.md) · [Español](README.es.md) · [Français](README.fr.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Tiếng Việt](README.vi.md) · [中文 (简体)](README.zh-Hans.md) · [中文（繁體）](README.zh-Hant.md) · [Deutsch](README.de.md) · [Русский](README.ru.md)

Lachlan Chen banner

AgInTiFlow banner

# AgInTiFlow ![Node.js](https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs&logoColor=white) ![Playwright](https://img.shields.io/badge/Browser-Playwright-2EAD33?logo=playwright&logoColor=white) ![CLI + Web](https://img.shields.io/badge/Interface-CLI%20%2B%20Web-0ea5e9) ![Text Models](https://img.shields.io/badge/Text-LocalLLM%20%2B%20Optional%20Hosted-2563eb) ![Aux Image](https://img.shields.io/badge/Aux%20Image-GRS%20AI%20%2B%20Venice-ec4899) ![Sandbox](https://img.shields.io/badge/Shell-Docker%20Sandbox-f97316) ![Status](https://img.shields.io/badge/Status-Prototype-7c3aed) **Des agents à faible coût, conscients du projet, pour des problèmes réels.** AgInTiFlow est un espace de travail d'agents project-aware pour la R&D hybride wet-dry, l'intelligence hardware-aware, l'automatisation logicielle et les workflows industriels. De la planification de laboratoire à l'analyse de données, du contrôle matériel aux scripts de production, et de la microscopie, des drones et des robots aux rapports, il aide les agents à travailler via API, Web ou CLI avec supervision SCS, workflows AAPS, exécution protégée et preuves durables. En bref : lancez `aginti` dans un projet, donnez-lui une tâche, inspectez son plan, voyez chaque appel d’outil, reprenez plus tard et gardez les sorties dans votre workspace. > **Avis de fraîcheur :** Cette traduction peut être en retard sur certains détails du [README anglais actuel](../README.md) et de la [référence d’exécution local-first](../docs/local-first-agent-runtime.md). Par défaut, AgInTiFlow utilise LocalLLM sur `http://127.0.0.1:8008/v1`, avec `localllm-fast` et `localllm-deep`. Les fournisseurs hébergés sont des upgrades facultatifs et explicites : les clés ambiantes ne les sélectionnent pas et ne déclenchent aucun fallback automatique. La génération d’images auxiliaire reste désactivée jusqu’à son activation explicite. **Liens** | Ressource | URL | | --- | --- | | Website | [https://flow.lazying.art](https://flow.lazying.art) | | GitHub | [https://github.com/lazyingart/AgInTiFlow](https://github.com/lazyingart/AgInTiFlow) | | npm | [https://www.npmjs.com/package/@lazyingart/agintiflow](https://www.npmjs.com/package/@lazyingart/agintiflow) | | AAPS npm | [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps) | | Positionnement produit | [../references/agintiflow-product-positioning.md](../references/agintiflow-product-positioning.md) | | README complet archivé | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) |

AgInTiFlow interactive CLI launch screen with colorful terminal banner, Docker workspace status, and chat input panel

## Pourquoi ce projet existe La plupart des outils d’agents sont soit une boîte de chat à état caché, soit une boucle coûteuse à modèle unique. AgInTiFlow repose sur une autre philosophie : | Principe | Effet concret | | --- | --- | | L’intelligence locale change l’architecture | La base utilise la passerelle LocalLLM voisine pour les routes et l’exécution principale privées et locales ; les modèles hébergés restent des upgrades explicites. | | Inspectable plutôt que mystérieux | Plans, appels d’outils, diffs de fichiers, sorties de commandes, artifacts canvas et événements de session sont sauvegardés et reprenables. | | Modèles par rôles | Route, main, spare, wrapper et auxiliary image sont séparés. LocalLLM fournit Fast/Deep par défaut ; DeepSeek, OpenAI, OpenRouter, Qwen et Venice sont sélectionnés explicitement. | | Scouts avant gros travail | Des scouts parallèles cartographient architecture, tests, risques, symboles et points d’intégration avant que l’exécuteur principal modifie les fichiers. | | SCS pour le travail risqué | Student-Committee-Supervisor ajoute une porte typée : committee rédige, student approuve/surveille, supervisor exécute. Utilisez `/scs` ou `--scs auto`. | | AAPS pour grands workflows | AAPS décrit des scripts de pipeline agentic top-down ; AgInTiFlow peut servir de backend interactif pour les valider, compiler et exécuter. | | Sécurité locale par défaut | Docker workspace, garde-fous de chemins, redaction des secrets, blocage de npm publish/token et logs visibles gardent l’agent pratique sans opacité. | ## Démarrage rapide Installez et ouvrez un projet : ```bash npm install -g @lazyingart/agintiflow cd /path/to/your-project aginti init aginti ``` Par défaut, AgInTiFlow se connecte sans clé hébergée au service LocalLLM voisin sur `http://127.0.0.1:8008/v1` : `localllm-fast` pour route et `localllm-deep` pour main. Pour utiliser DeepSeek, OpenAI, OpenRouter, Qwen ou Venice, sélectionnez explicitement le fournisseur et lancez l’assistant d’authentification. Un échec LocalLLM arrête l’exécution avec une erreur claire et n’envoie jamais automatiquement la tâche vers le cloud : ```bash aginti auth aginti auth deepseek aginti auth openrouter aginti auth venice aginti login grsai ``` Une clé hébergée sauvegardée sert uniquement à l’authentification et ne change pas le fournisseur actif. Les outils d’image auxiliaires restent désactivés jusqu’à `/auxiliary on`, `/auxiliary image` ou l’option équivalente. Lancez l’interface Web depuis le même projet : ```bash aginti web --port 3210 # open http://127.0.0.1:3210 ``` Lancez un smoke test sans identifiants de modèle réel : ```bash aginti --provider mock --routing manual --allow-file-tools "Create notes/hello.md with a smoke-test note" ``` Définissez explicitement la langue, ou omettez-la pour suivre la locale système : ```bash aginti --language ja aginti --language zh-Hans aginti --language de ``` ## Commandes quotidiennes | Objectif | Commande | | --- | --- | | Démarrer le chat interactif | `aginti` ou `aginti chat` | | Démarrer l’app Web locale | `aginti web --port 3210` | | Sauvegarder les clés provider | `aginti auth`, `/auth`, `/login` | | Relire le repo courant | `/review [focus]` | | Activer/désactiver la porte SCS | `/scs` | | Utiliser SCS seulement pour le complexe | `/scs auto` ou `aginti --scs auto "task"` | | Travailler avec AAPS | `aginti aaps status`, `/aaps validate` | | Choisir les modèles | `/route`, `/model`, `/spare`, `/wrapper`, `/auxiliary model` | | Activer le raccourci Venice | `/venice` | | Générer des images | `/auxiliary image`, puis demandez une image | | Reprendre le projet courant | `aginti resume` | | Parcourir toutes les sessions | `aginti resume --all-sessions` | | Mettre en file dans une session active | `aginti queue "extra instruction"` | | Nettoyer les sessions vides | `aginti --remove-empty-sessions` | | Vérifier les capacités | `aginti capabilities`, `aginti doctor --capabilities` | | Synchroniser les skills revues | `aginti skillmesh status`, `aginti skillmesh sync` | | Mettre à jour la CLI | `aginti update` | Le chat interactif prend en charge la complétion slash, les sélecteurs Up/Down, l’entrée multilignes avec `Ctrl+J`, l’historique complet de reprise, le rendu Markdown, l’état visible d’exécution, les messages ASAP pipe pendant un run et l’interruption/reprise propre avec `Ctrl+C`. Les commandes interactives installées vérifient aussi npm pour une nouvelle version d’AgInTiFlow et affichent un sélecteur update/skip ; les checkouts source et automatisations non-TTY ne sont pas perturbés. Pour une reprise one-shot entièrement contrôlée, utilisez un session id explicite et choisissez le profil de tâche volontairement. Utilisez `auto` pour le routing normal ou `android` pour le travail Android/émulateur : ```bash PROFILE=android # or auto aginti --resume \ --profile "$PROFILE" \ --sandbox-mode host \ --package-install-policy allow \ --approve-package-installs \ --allow-shell \ --allow-file-tools \ --allow-destructive \ "Take a fresh screenshot of the running app in the emulator, save it with a durable filename in this project, and keep git status clean." ``` ## Captures réelles | Lancement CLI | Vue Web | | --- | --- | | AgInTiFlow CLI launch | AgInTiFlow web app overview | | Contrôles de tâche | Sortie runtime | | --- | --- | | AgInTiFlow task controls | AgInTiFlow runtime output | | Historique de conversation | État sandbox | | --- | --- | | AgInTiFlow conversation history | AgInTiFlow sandbox status | | Vue mobile | | --- | | AgInTiFlow mobile overview | Les anciennes captures de lancement sont conservées dans le dépôt source sous [demos/archive/](https://github.com/lazyingart/AgInTiFlow/tree/main/demos/archive). ## Capacités principales | Capacité | Ce que fournit AgInTiFlow | | --- | --- | | Workspace agent CLI | Chat terminal persistant avec cwd du projet, reprise de session, état modèle/outil visible et indices de commande propres. | | Workspace Web local | UI navigateur pour sessions, logs runtime, artifacts, réglages de modèles, contrôles projet, previews canvas et état sandbox. | | File tools | `inspect_project`, `list_files`, `read_file`, `search_files`, `write_file`, `apply_patch`, `open_workspace_file`, `preview_workspace`. | | Shell tools | Exécution shell protégée en host ou Docker workspace avec politique d’installation et contrôles de commande. | | Browser tools | Actions Playwright avec démarrage paresseux et allowlists de domaines optionnelles. | | Model routing | LocalLLM Fast/Deep sont les valeurs par défaut. DeepSeek, OpenAI, OpenRouter, Qwen, Venice et mock sont des routes explicites ; les clés ambiantes ne provoquent aucun fallback hébergé. | | Patch workflow | Enveloppes patch style Codex, unified diffs, remplacements exacts, hashes, diffs compacts et garde-fous de chemin. | | Parallel scouts | Appels scout optionnels pour architecture, implémentation, review, tests, git flow, recherche, symbol tracing et risques dépendances. | | SCS mode | Porte qualité optionnelle Student-Committee-Supervisor pour tâches complexes ou risquées. | | AAPS adapter | Intégration optionnelle `@lazyingart/aaps` pour init, validate, parse, compile, dry-run et run de workflows `.aaps`. | | Image generation | GRS AI et Venice sont désactivés par défaut et exigent une activation explicite ; sauvegarder une clé ne les active pas et ne choisit aucun fournisseur de remplacement. | | Skill library | Skills Markdown intégrées pour code, sites, Android/iOS, Python, Rust, Java, LaTeX, rédaction, reviews, GitHub, AAPS, etc. | | Skill Mesh | Enregistrement/partage strict optionnel de packs de skills réutilisables et revus. Sans usage, AgInTiFlow fonctionne normalement sans partage en arrière-plan. | | UI multilingue | CLI et docs en anglais, japonais, chinois simplifié/traditionnel, coréen, français, espagnol, arabe, vietnamien, allemand et russe. | ## Modèles et rôles AgInTiFlow ne traite pas “le modèle” comme un seul réglage global. Il y a des rôles : | Rôle | Défaut | Usage | | --- | --- | --- | | Route | `localllm/localllm-fast` | Planification locale, triage, tâches courtes et décisions de routing. | | Main | `localllm/localllm-deep` | Exécuteur local pour coding complexe, debugging, rédaction, recherche et longues tâches. | | Spare | `localllm/localllm-deep` medium | Route locale de cross-check ; un spare hébergé doit être sélectionné explicitement. | | Wrapper | `codex/gpt-5.5` medium | Conseiller externe optionnel de coding-agent. | | Auxiliary | `grsai/nano-banana-2` (off) | Images et outils non textuels uniquement après activation explicite ; aucun failover guidé par les clés. | Sélecteurs utiles : ```text /models /route /model /spare /wrapper /auxiliary model /venice ``` Venice peut servir facultativement aux travaux créatifs uncensored ou moins restreints. LocalLLM reste la base locale ; DeepSeek et les autres fournisseurs hébergés sont uniquement des upgrades explicites. Voir [../docs/model-selection.md](../docs/model-selection.md), [../docs/local-first-agent-runtime.md](../docs/local-first-agent-runtime.md) et [../references/venice-model-reference.md](../references/venice-model-reference.md). ## AAPS et grands workflows AAPS est la couche pipeline-script ; AgInTiFlow est le backend interactif agent/outils. ```bash aginti aaps status aginti aaps init "Project Workflow" aginti aaps validate aginti aaps compile check ``` Dans le chat : ```text /aaps on /aaps validate /aaps dry-run workflows/main.aaps ``` Utilisez AAPS quand la tâche dépasse un chat : développement d’apps en étapes, workflows papier/livre, portes de validation, étapes de reprise, production d’artifacts ou scripts agentic top-down. Voir [../docs/aaps.md](../docs/aaps.md) et le package [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps). ## Référence rapide API locale L’app Web expose des APIs locales pour l’UI et l’automatisation. Ces endpoints rapportent l’état sans exposer les API keys brutes ni les npm tokens : ```bash curl http://127.0.0.1:3210/api/config curl http://127.0.0.1:3210/api/capabilities curl http://127.0.0.1:3210/api/sandbox/status curl -X POST http://127.0.0.1:3210/api/sandbox/preflight \ -H 'Content-Type: application/json' \ -d '{"sandboxMode":"docker-workspace","buildImage":true}' curl http://127.0.0.1:3210/api/workspace/changes curl "http://127.0.0.1:3210/api/sessions//artifacts" curl "http://127.0.0.1:3210/api/sessions//inbox" ``` Lancer le smoke test API sans credentials : ```bash npm run smoke:web-api ``` ## Stockage, sécurité et reprise AgInTiFlow stocke les sessions canoniques au centre et ne garde que des pointeurs locaux côté projet : | Emplacement | Rôle | | --- | --- | | `~/.agintiflow/sessions//` | État canonique, événements, état navigateur, artifacts, snapshots, fichiers canvas. | | `/.aginti-sessions/` | Pointeurs de session locaux et base Web UI. Ignoré par git. | | `/.aginti/.env` | API keys optionnelles locales au projet, permissions restreintes. Ignoré par git. | | `/AGINTI.md` | Instructions projet éditables et préférences locales durables. Commit possible s’il n’y a pas de secrets. | Défauts de sécurité : - Docker workspace mode est le défaut normal CLI/Web pour le coding pratique et la génération d’artifacts. - Les file tools bloquent chemins ressemblant à des secrets, `.env`, `.git`, écritures `node_modules`, échappements absolus, fichiers énormes et édition binaire. - Les shell commands sont vérifiées par policy ; npm publish, npm token commands, sudo, git destructif et lectures de credentials sont bloqués. - Les écritures de fichiers enregistrent hashes et diffs compacts. - Les appels d’outils et résultats sont loggés dans des événements de session structurés. - Web et CLI utilisent le même session store, donc un run peut être inspecté et repris plus tard. Notes runtime détaillées : [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md), [../docs/patch-tools.md](../docs/patch-tools.md), [../docs/agent-runtime-pipe.md](../docs/agent-runtime-pipe.md). ## Configuration Variables d’environnement courantes : ```bash AGENT_PROVIDER=localllm LOCALLLM_BASE_URL=http://127.0.0.1:8008/v1 LOCALLLM_API_KEY=local-dev-key AGINTI_LOCALLLM_ROUTE_MODEL=localllm-fast AGINTI_LOCALLLM_MAIN_MODEL=localllm-deep # Upgrades hébergés facultatifs et explicites ; jamais de fallback LocalLLM automatique. DEEPSEEK_API_KEY=... OPENAI_API_KEY=... OPENROUTER_API_KEY=... QWEN_API_KEY=... VENICE_API_KEY=... GRSAI_API_KEY=... AGENT_ROUTING_MODE=smart AGINTI_TASK_PROFILE=auto AGINTI_LANGUAGE=en SANDBOX_MODE=docker-workspace PACKAGE_INSTALL_POLICY=allow COMMAND_CWD=/path/to/project ``` Clés locales au projet : ```bash aginti init printf '%s' "$DEEPSEEK_API_KEY" | aginti keys set deepseek --stdin printf '%s' "$VENICE_API_KEY" | aginti keys set venice --stdin ``` Plus de détails : - [../docs/model-selection.md](../docs/model-selection.md) - [../docs/auxiliary-image-generation.md](../docs/auxiliary-image-generation.md) - [../docs/cli-i18n.md](../docs/cli-i18n.md) - [../docs/skillmesh.md](../docs/skillmesh.md) ## Carte de documentation | Sujet | Lien | | --- | --- | | AAPS adapter | [../docs/aaps.md](../docs/aaps.md) | | Sélection des modèles et rôles | [../docs/model-selection.md](../docs/model-selection.md) | | SCS mode | [../docs/student-committee-supervisor.md](../docs/student-committee-supervisor.md) | | Ingénierie de grandes codebases | [../docs/large-codebase-engineering.md](../docs/large-codebase-engineering.md) | | Runtime modes et autonomie | [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md) | | Skills et outils | [../docs/skills-and-tools.md](../docs/skills-and-tools.md) | | Skill Mesh | [../docs/skillmesh.md](../docs/skillmesh.md) | | Housekeeping logs | [../docs/housekeeping.md](../docs/housekeeping.md) | | Publication npm | [../docs/npm-publishing.md](../docs/npm-publishing.md) | | Roadmap produit | [../docs/productive-agent-roadmap.md](../docs/productive-agent-roadmap.md) | | Curriculum de capacités supervisées | [../docs/supervised-capability-curriculum.md](../docs/supervised-capability-curriculum.md) | | Ancien README complet | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) | ## Développement Exécuter depuis les sources : ```bash git clone https://github.com/lazyingart/AgInTiFlow.git cd AgInTiFlow npm install npx playwright install chromium npm run check npm test ``` Démarrer le Web local depuis les sources : ```bash npm run web # open http://127.0.0.1:3210 ``` Smoke checks utiles : ```bash npm run smoke:web-api npm run smoke:coding-tools npm run smoke:aaps-adapter npm run smoke:cli-chat npm run smoke:toolchain-docker ``` Les smoke scripts utilisent le provider mock local sauf s’ils sont explicitement marqués comme tests real-provider. ## Notes de release AgInTiFlow est publié sous `@lazyingart/agintiflow`. Le chemin recommandé est GitHub Actions Trusted Publishing avec npm provenance. La publication locale par token n’est qu’un fallback de bootstrap et ne doit jamais commiter `.env`, `.npmrc`, npm tokens, OTPs ou debug logs. Voir [../docs/npm-publishing.md](../docs/npm-publishing.md) pour le workflow complet. ## Soutien Si ce projet vous est utile, vous pouvez soutenir son développement ici : | Soutien | URL | | --- | --- | | GitHub Sponsors: LazyingArt | [https://github.com/sponsors/lazyingart](https://github.com/sponsors/lazyingart) | | GitHub Sponsors: Lachlan Chen | [https://github.com/sponsors/lachlanchen](https://github.com/sponsors/lachlanchen) | | LazyingArt | [https://lazying.art](https://lazying.art) | | Chat | [https://chat.lazying.art](https://chat.lazying.art) | | OnlyIdeas | [https://onlyideas.art](https://onlyideas.art) | AgInTiFlow est développé par AgInTi Lab, LazyingArt LLC.