[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) **Недорогие, проектно-ориентированные агенты для реальных задач.** AgInTiFlow — project-aware рабочее пространство для агентов, предназначенное для hybrid wet-dry R&D, hardware-aware intelligence, автоматизации software и промышленных workflow. От планирования лабораторных работ до анализа данных, от управления hardware до production scripts, от microscopy, drones и robots до отчетов, оно помогает агентам работать через API, Web или CLI с SCS supervision, AAPS workflows, guarded execution и долговечной доказательной базой. Коротко: запустите `aginti` внутри проекта, дайте задачу, проверьте план, увидьте каждый tool call, возобновите работу позже и сохраняйте результаты в рабочей папке. > **Примечание об актуальности:** Этот перевод может отставать в отдельных деталях от [текущего английского README](../README.md) и [описания local-first runtime](../docs/local-first-agent-runtime.md). По умолчанию используется LocalLLM по адресу `http://127.0.0.1:8008/v1` с `localllm-fast` и `localllm-deep`. Hosted-провайдеры — только необязательные явные upgrades: ключи из окружения не выбирают их и не запускают автоматический fallback. Вспомогательная генерация изображений также выключена до явного включения. **Ссылки** | Ресурс | 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) | | Позиционирование продукта | [../references/agintiflow-product-positioning.md](../references/agintiflow-product-positioning.md) | | Полный архив README | [../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

## Зачем это нужно Большинство агентных инструментов — это либо чат с скрытым состоянием, либо дорогой цикл вокруг одной модели. AgInTiFlow строится на другой философии: | Принцип | Практический смысл | | --- | --- | | Локальный интеллект меняет архитектуру | Базовый режим использует соседний gateway LocalLLM для приватных локальных route/main lanes; Hosted-модели остаются явными upgrades. | | Проверяемость лучше загадочности | Планы, tool calls, file diffs, вывод команд, canvas artifacts и session events сохраняются и могут быть возобновлены. | | Модели по ролям | Route, main, spare, wrapper и auxiliary image — отдельные роли. LocalLLM предоставляет Fast/Deep по умолчанию; DeepSeek, OpenAI, OpenRouter, Qwen и Venice выбираются явно. | | Scouts перед большой работой | Параллельные scouts дешево картируют архитектуру, тесты, риски, символы и точки интеграции до того, как main executor начнет редактировать файлы. | | SCS для рискованных задач | Student-Committee-Supervisor добавляет typed gate: committee пишет черновик, student утверждает/мониторит, supervisor исполняет. Используйте `/scs` или `--scs auto`. | | AAPS для больших workflow | AAPS описывает top-down agentic pipeline scripts; AgInTiFlow может быть интерактивным backend для validation, compilation и execution. | | Локальная безопасность по умолчанию | Docker workspace, path guardrails, secret redaction, блокировка npm publish/token commands и видимые logs делают агента практичным, но не непрозрачным. | ## Быстрый старт Установите и откройте проект: ```bash npm install -g @lazyingart/agintiflow cd /path/to/your-project aginti init aginti ``` По умолчанию AgInTiFlow без Hosted-key подключается к соседнему сервису LocalLLM по адресу `http://127.0.0.1:8008/v1`: `localllm-fast` для route и `localllm-deep` для main. Для DeepSeek, OpenAI, OpenRouter, Qwen или Venice явно выберите провайдера и запустите auth wizard. Ошибка LocalLLM останавливает запуск с понятным сообщением и никогда автоматически не отправляет задачу в cloud: ```bash aginti auth aginti auth deepseek aginti auth openrouter aginti auth venice aginti login grsai ``` Сохраненный Hosted-key используется только для аутентификации и не меняет активного провайдера. Вспомогательные image tools остаются выключенными до явного `/auxiliary on`, `/auxiliary image` или соответствующего переключателя. Запустите Web UI из того же проекта: ```bash aginti web --port 3210 # open http://127.0.0.1:3210 ``` Smoke test без реальных модельных credentials: ```bash aginti --provider mock --routing manual --allow-file-tools "Create notes/hello.md with a smoke-test note" ``` Задайте язык явно или опустите параметр, чтобы использовать system locale: ```bash aginti --language ja aginti --language zh-Hans aginti --language de ``` ## Ежедневные команды | Цель | Команда | | --- | --- | | Запустить интерактивный чат | `aginti` или `aginti chat` | | Запустить локальное Web-приложение | `aginti web --port 3210` | | Сохранить provider keys | `aginti auth`, `/auth`, `/login` | | Сделать review текущего repo | `/review [focus]` | | Переключить SCS quality gate | `/scs` | | Использовать SCS только для сложной работы | `/scs auto` или `aginti --scs auto "task"` | | Работать с AAPS workflows | `aginti aaps status`, `/aaps validate` | | Выбрать модели | `/route`, `/model`, `/spare`, `/wrapper`, `/auxiliary model` | | Включить Venice shortcut | `/venice` | | Генерировать изображения | `/auxiliary image`, затем попросите изображение | | Возобновить текущий проект | `aginti resume` | | Просмотреть все sessions | `aginti resume --all-sessions` | | Поставить сообщение в running session | `aginti queue "extra instruction"` | | Удалить пустые sessions | `aginti --remove-empty-sessions` | | Проверить capabilities | `aginti capabilities`, `aginti doctor --capabilities` | | Синхронизировать проверенные skills | `aginti skillmesh status`, `aginti skillmesh sync` | | Обновить CLI | `aginti update` | Интерактивный чат поддерживает slash completion, Up/Down selectors, multiline input через `Ctrl+J`, полную resume history, Markdown rendering, видимый run status, ASAP pipe messages во время выполнения и чистое interrupt/resume через `Ctrl+C`. Установленные interactive commands также проверяют npm на новую версию AgInTiFlow и показывают selector update/skip; source checkouts и non-TTY automation не затрагиваются. Для полностью контролируемого one-shot resume используйте явный session id и осознанно выберите task profile. `auto` подходит для обычного routing, `android` — для Android/emulator работы: ```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." ``` ## Реальные скриншоты | CLI launch | Web app overview | | --- | --- | | AgInTiFlow CLI launch | AgInTiFlow web app overview | | Task controls | Runtime output | | --- | --- | | AgInTiFlow task controls | AgInTiFlow runtime output | | Conversation history | Sandbox status | | --- | --- | | AgInTiFlow conversation history | AgInTiFlow sandbox status | | Mobile overview | | --- | | AgInTiFlow mobile overview | Старые launch screenshots сохранены в source repository в [demos/archive/](https://github.com/lazyingart/AgInTiFlow/tree/main/demos/archive). ## Основные возможности | Возможность | Что дает AgInTiFlow | | --- | --- | | CLI agent workspace | Persistent terminal chat с project cwd, session resume, видимым model/tool state и понятными command hints. | | Local web workspace | Browser UI для sessions, runtime logs, artifacts, model settings, project controls, canvas previews и sandbox status. | | File tools | `inspect_project`, `list_files`, `read_file`, `search_files`, `write_file`, `apply_patch`, `open_workspace_file`, `preview_workspace`. | | Shell tools | Защищенное выполнение shell на host или Docker workspace с package-install policy и command safety checks. | | Browser tools | Playwright browser actions с lazy startup и optional domain allowlists. | | Model routing | LocalLLM Fast/Deep используются по умолчанию. DeepSeek, OpenAI, OpenRouter, Qwen, Venice и mock — явные routes; ключи окружения не вызывают Hosted-fallback. | | Patch workflow | Codex-style patch envelopes, unified diffs, exact replacements, hashes, compact diffs и path guardrails. | | Parallel scouts | Optional scout calls для architecture, implementation, review, tests, git flow, research, symbol tracing и dependency risk. | | SCS mode | Optional Student-Committee-Supervisor quality gate для сложных или рискованных задач. | | AAPS adapter | Optional `@lazyingart/aaps` integration для `.aaps` workflow init, validate, parse, compile, dry-run и run. | | Image generation | GRS AI и Venice выключены по умолчанию и требуют явного включения; сохранение ключа не включает их и не выбирает запасного провайдера. | | Skill library | Built-in Markdown skills для code, websites, Android/iOS, Python, Rust, Java, LaTeX, writing, reviews, GitHub, AAPS и другого. | | Skill Mesh | Optional strict skill recording/sharing для проверенных reusable skill packs. Если не используется, AgInTiFlow работает нормально без background sharing. | | Multilingual UI | CLI и docs поддерживают English, Japanese, Simplified/Traditional Chinese, Korean, French, Spanish, Arabic, Vietnamese, German и Russian. | ## Модели и роли AgInTiFlow не считает “модель” единственной глобальной настройкой. Есть роли: | Роль | Default | Назначение | | --- | --- | --- | | Route | `localllm/localllm-fast` | Локальный planner, triage, short tasks и routing decisions. | | Main | `localllm/localllm-deep` | Локальный executor для complex coding, debugging, writing, research и long tasks. | | Spare | `localllm/localllm-deep` medium | Локальная cross-check lane; Hosted-spare требует явного выбора. | | Wrapper | `codex/gpt-5.5` medium | Optional external coding-agent advisor. | | Auxiliary | `grsai/nano-banana-2` (off) | Image generation и non-text tools только после явного включения; без failover по ключам. | Полезные selectors: ```text /models /route /model /spare /wrapper /auxiliary model /venice ``` Venice можно опционально использовать для uncensored или менее ограниченной creative work. LocalLLM остается локальной базой; DeepSeek и другие Hosted-провайдеры — только явные upgrades. См. [../docs/model-selection.md](../docs/model-selection.md), [../docs/local-first-agent-runtime.md](../docs/local-first-agent-runtime.md) и [../references/venice-model-reference.md](../references/venice-model-reference.md). ## AAPS и большие workflow AAPS — слой pipeline-script; AgInTiFlow — интерактивный agent/tool backend. ```bash aginti aaps status aginti aaps init "Project Workflow" aginti aaps validate aginti aaps compile check ``` В чате: ```text /aaps on /aaps validate /aaps dry-run workflows/main.aaps ``` Используйте AAPS, когда задача больше одного чата: app development со stages, paper/book workflows, validation gates, recovery steps, artifact production или top-down agentic scripts. См. [../docs/aaps.md](../docs/aaps.md) и package [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps). ## Краткая справка по локальному API Web app предоставляет локальные APIs для UI и automation. Эти endpoints возвращают состояние, не раскрывая raw API keys или 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" ``` Запустить credential-free API smoke test: ```bash npm run smoke:web-api ``` ## Хранение, безопасность и resume AgInTiFlow хранит canonical sessions централизованно и оставляет только project-local pointers: | Location | Purpose | | --- | --- | | `~/.agintiflow/sessions//` | Canonical state, events, browser state, artifacts, snapshots, canvas files. | | `/.aginti-sessions/` | Project-local session pointers и Web UI database. Git ignored. | | `/.aginti/.env` | Optional project-local API keys с restricted permissions. Git ignored. | | `/AGINTI.md` | Editable project instructions и durable local preferences. Safe to commit, если нет secrets. | Safety defaults: - Docker workspace mode — обычный default CLI/Web для practical coding и artifact generation. - File tools блокируют secret-like paths, `.env`, `.git`, `node_modules` writes, absolute escapes, huge files и binary edits. - Shell commands проходят policy check; npm publish, npm token commands, sudo, destructive git и credential reads блокируются. - File writes записывают hashes и compact diffs. - Tool calls и results логируются в structured session events. - Web и CLI используют один session store, поэтому run можно позже inspect/resume. Подробности runtime: [../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). ## Конфигурация Частые переменные окружения: ```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 # Необязательные явные hosted-upgrade; это не автоматический fallback для LocalLLM. 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 ``` Project-local keys: ```bash aginti init printf '%s' "$DEEPSEEK_API_KEY" | aginti keys set deepseek --stdin printf '%s' "$VENICE_API_KEY" | aginti keys set venice --stdin ``` Подробнее: - [../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) ## Карта документации | Тема | Ссылка | | --- | --- | | AAPS adapter | [../docs/aaps.md](../docs/aaps.md) | | Model selection and roles | [../docs/model-selection.md](../docs/model-selection.md) | | SCS mode | [../docs/student-committee-supervisor.md](../docs/student-committee-supervisor.md) | | Large-codebase engineering | [../docs/large-codebase-engineering.md](../docs/large-codebase-engineering.md) | | Runtime modes and autonomy | [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md) | | Skills and tools | [../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) | | npm publishing | [../docs/npm-publishing.md](../docs/npm-publishing.md) | | Product roadmap | [../docs/productive-agent-roadmap.md](../docs/productive-agent-roadmap.md) | | Supervised capability curriculum | [../docs/supervised-capability-curriculum.md](../docs/supervised-capability-curriculum.md) | | Полная старая README | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) | ## Разработка Запуск из исходников: ```bash git clone https://github.com/lazyingart/AgInTiFlow.git cd AgInTiFlow npm install npx playwright install chromium npm run check npm test ``` Запуск local web из исходников: ```bash npm run web # open http://127.0.0.1:3210 ``` Полезные smoke checks: ```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 ``` Smoke scripts используют local mock provider, если явно не отмечены как real-provider tests. ## Release Notes AgInTiFlow публикуется как `@lazyingart/agintiflow`. Предпочтительный release path — GitHub Actions Trusted Publishing с npm provenance. Local token publishing — только fallback для bootstrap; нельзя commit `.env`, `.npmrc`, npm tokens, OTPs или debug logs. Полный release workflow: [../docs/npm-publishing.md](../docs/npm-publishing.md). ## Поддержка Если проект полезен, можно поддержать разработку здесь: | Support | 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 разработан AgInTi Lab, LazyingArt LLC.