[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) **Agent chi phí thấp, hiểu dự án, cho các vấn đề thực tế.** AgInTiFlow là một project-aware agent workspace cho hybrid wet-dry R&D, hardware-aware intelligence, software automation và industrial workflows. Từ lập kế hoạch thí nghiệm đến phân tích dữ liệu, từ điều khiển phần cứng đến production scripts, và từ microscopy, drones, robots đến reports, nó giúp agent làm việc qua API, Web hoặc CLI với SCS supervision, AAPS workflows, guarded execution và durable evidence. Nói ngắn gọn: chạy `aginti` trong một dự án, giao nhiệm vụ, xem kế hoạch, kiểm tra từng tool call, tiếp tục lại sau, và giữ kết quả trong workspace. > **Lưu ý về độ mới:** Bản dịch này có thể chậm hơn một số chi tiết trong [README tiếng Anh hiện tại](../README.md) và [tài liệu local-first runtime](../docs/local-first-agent-runtime.md). Mặc định là LocalLLM tại `http://127.0.0.1:8008/v1`, dùng `localllm-fast` và `localllm-deep`. Hosted provider chỉ là upgrade tùy chọn được chọn rõ ràng; key trong môi trường không tự chọn provider và không gây fallback tự động. Auxiliary image generation cũng tắt cho đến khi được bật rõ ràng. **Liên kết** | Tài nguyên | 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) | | Định vị sản phẩm | [../references/agintiflow-product-positioning.md](../references/agintiflow-product-positioning.md) | | README đầy đủ đã lưu trữ | [../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

## Vì sao tồn tại Phần lớn công cụ agent hoặc là một hộp chat với trạng thái ẩn, hoặc là một vòng lặp một mô hình rất đắt. AgInTiFlow theo một triết lý khác: | Nguyên tắc | Ý nghĩa thực tế | | --- | --- | | Trí tuệ cục bộ thay đổi kiến trúc | Baseline dùng gateway LocalLLM bên cạnh cho route/main riêng tư và cục bộ; Hosted model vẫn là upgrade phải chọn rõ ràng. | | Có thể kiểm tra tốt hơn bí ẩn | Plan, tool call, file diff, command output, canvas artifact và session event đều được lưu và có thể resume. | | Mô hình theo vai trò | route, main, spare, wrapper và auxiliary image là các vai trò riêng. LocalLLM cung cấp Fast/Deep mặc định; DeepSeek, OpenAI, OpenRouter, Qwen và Venice phải được chọn rõ ràng. | | Scouts trước việc lớn | Parallel scouts có thể lập bản đồ architecture, tests, risks, symbols và integration points với chi phí thấp trước khi executor chính sửa file. | | SCS cho việc rủi ro cao | Student-Committee-Supervisor mode thêm typed gate: committee phác thảo, student phê duyệt/giám sát, supervisor thực thi. Dùng `/scs` hoặc `--scs auto`. | | AAPS cho workflow lớn | AAPS mô tả agentic pipeline script từ trên xuống; AgInTiFlow có thể là backend tương tác để validate, compile và execute các workflow đó. | | An toàn cục bộ mặc định | Docker workspace, path guardrail, secret redaction, chặn npm publish/token commands và log hiển thị giúp agent hữu dụng nhưng không mờ đục. | ## Bắt đầu nhanh Cài đặt và mở một dự án: ```bash npm install -g @lazyingart/agintiflow cd /path/to/your-project aginti init aginti ``` Theo mặc định, AgInTiFlow kết nối không cần Hosted key tới service LocalLLM bên cạnh tại `http://127.0.0.1:8008/v1`: `localllm-fast` cho route và `localllm-deep` cho main. Để dùng DeepSeek, OpenAI, OpenRouter, Qwen hoặc Venice, hãy chọn provider rõ ràng rồi chạy auth wizard. Lỗi LocalLLM dừng run với thông báo rõ ràng và không bao giờ tự gửi task lên cloud: ```bash aginti auth aginti auth deepseek aginti auth openrouter aginti auth venice aginti login grsai ``` Hosted key đã lưu chỉ dùng để xác thực và không đổi active provider. Auxiliary image tools vẫn tắt cho đến khi dùng rõ ràng `/auxiliary on`, `/auxiliary image` hoặc toggle tương ứng. Chạy Web UI từ cùng dự án: ```bash aginti web --port 3210 # open http://127.0.0.1:3210 ``` Chạy smoke test không cần credentials mô hình thật: ```bash aginti --provider mock --routing manual --allow-file-tools "Create notes/hello.md with a smoke-test note" ``` Chọn ngôn ngữ rõ ràng, hoặc bỏ qua để dùng system locale: ```bash aginti --language ja aginti --language zh-Hans aginti --language de ``` ## Lệnh hằng ngày | Mục tiêu | Lệnh | | --- | --- | | Bắt đầu chat tương tác | `aginti` hoặc `aginti chat` | | Bắt đầu web app cục bộ | `aginti web --port 3210` | | Lưu provider keys | `aginti auth`, `/auth`, `/login` | | Review repo hiện tại | `/review [focus]` | | Bật/tắt SCS quality gate | `/scs` | | Chỉ dùng SCS cho việc phức tạp | `/scs auto` hoặc `aginti --scs auto "task"` | | Làm việc với AAPS workflows | `aginti aaps status`, `/aaps validate` | | Chọn models | `/route`, `/model`, `/spare`, `/wrapper`, `/auxiliary model` | | Bật shortcut Venice | `/venice` | | Tạo ảnh | `/auxiliary image`, rồi mô tả ảnh | | Resume dự án hiện tại | `aginti resume` | | Xem mọi session | `aginti resume --all-sessions` | | Queue vào session đang chạy | `aginti queue "extra instruction"` | | Dọn session trống | `aginti --remove-empty-sessions` | | Kiểm tra capabilities | `aginti capabilities`, `aginti doctor --capabilities` | | Sync skills đã review | `aginti skillmesh status`, `aginti skillmesh sync` | | Cập nhật CLI | `aginti update` | Interactive chat hỗ trợ slash completion, selector Up/Down, multiline input bằng `Ctrl+J`, full resume history, Markdown rendering, run status hiển thị, ASAP pipe message trong lúc chạy, và interrupt/resume sạch bằng `Ctrl+C`. Các command tương tác đã cài cũng kiểm tra npm để tìm bản AgInTiFlow mới và hiển thị selector update/skip; source checkout và non-TTY automation không bị ảnh hưởng. Để one-shot resume với kiểm soát đầy đủ, dùng session id rõ ràng và chọn task profile có chủ đích. Dùng `auto` cho routing bình thường hoặc `android` cho việc 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." ``` ## Ảnh chụp thật | 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 | Ảnh launch cũ được giữ trong source repository tại [demos/archive/](https://github.com/lazyingart/AgInTiFlow/tree/main/demos/archive). ## Năng lực chính | Năng lực | AgInTiFlow cung cấp | | --- | --- | | CLI agent workspace | Terminal chat bền vững với project cwd, session resume, model/tool state hiển thị và command hints rõ ràng. | | Local web workspace | Browser UI cho sessions, runtime logs, artifacts, model settings, project controls, canvas previews và sandbox status. | | File tools | `inspect_project`, `list_files`, `read_file`, `search_files`, `write_file`, `apply_patch`, `open_workspace_file`, `preview_workspace`. | | Shell tools | Host hoặc Docker workspace shell execution có guard, package-install policy và command safety checks. | | Browser tools | Playwright browser actions với lazy startup và optional domain allowlists. | | Model routing | LocalLLM Fast/Deep là mặc định. DeepSeek, OpenAI, OpenRouter, Qwen, Venice và mock là route rõ ràng; key môi trường không gây Hosted fallback. | | Patch workflow | Codex-style patch envelopes, unified diffs, exact replacements, hashes, compact diffs và path guardrails. | | Parallel scouts | Optional scout calls cho architecture, implementation, review, tests, git flow, research, symbol tracing và dependency risk. | | SCS mode | Optional Student-Committee-Supervisor quality gate cho tác vụ phức tạp hoặc rủi ro. | | AAPS adapter | Optional `@lazyingart/aaps` integration cho `.aaps` workflow init, validate, parse, compile, dry-run và run. | | Image generation | GRS AI và Venice tắt mặc định và cần bật rõ ràng; lưu key không tự bật chúng hoặc chọn provider thay thế. | | Skill library | Built-in Markdown skills cho code, websites, Android/iOS, Python, Rust, Java, LaTeX, writing, reviews, GitHub, AAPS và nhiều hơn. | | Skill Mesh | Optional strict skill recording/sharing cho reusable skill packs đã review. Nếu không dùng, AgInTiFlow chạy bình thường không background sharing. | | Multilingual UI | CLI và docs hỗ trợ English, Japanese, Simplified/Traditional Chinese, Korean, French, Spanish, Arabic, Vietnamese, German và Russian. | ## Models và roles AgInTiFlow không xem “the model” là một global setting duy nhất. Nó có các role: | Role | Default | Mục đích | | --- | --- | --- | | Route | `localllm/localllm-fast` | Local planner, triage, short tasks và routing decisions. | | Main | `localllm/localllm-deep` | Local executor cho coding phức tạp, debugging, writing, research và long tasks. | | Spare | `localllm/localllm-deep` medium | Local cross-check lane; Hosted spare phải được chọn rõ ràng. | | Wrapper | `codex/gpt-5.5` medium | Optional external coding-agent advisor. | | Auxiliary | `grsai/nano-banana-2` (off) | Image generation và non-text tools chỉ sau khi bật rõ ràng; không failover provider dựa trên key. | Selectors hữu ích: ```text /models /route /model /spare /wrapper /auxiliary model /venice ``` Venice có thể dùng tùy chọn cho uncensored hoặc creative work ít hạn chế hơn. LocalLLM vẫn là baseline cục bộ; DeepSeek và các Hosted provider khác chỉ là upgrade phải chọn rõ ràng. Xem [../docs/model-selection.md](../docs/model-selection.md), [../docs/local-first-agent-runtime.md](../docs/local-first-agent-runtime.md) và [../references/venice-model-reference.md](../references/venice-model-reference.md). ## AAPS và workflow lớn AAPS là tầng pipeline-script; AgInTiFlow là backend agent/tool tương tác. ```bash aginti aaps status aginti aaps init "Project Workflow" aginti aaps validate aginti aaps compile check ``` Trong chat: ```text /aaps on /aaps validate /aaps dry-run workflows/main.aaps ``` Dùng AAPS khi task lớn hơn một lần chat: app development có stages, paper/book workflows, validation gates, recovery steps, artifact production hoặc top-down agentic scripts. Xem [../docs/aaps.md](../docs/aaps.md) và package [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps). ## Local API quick reference Web app cung cấp local APIs cho UI và automation. Các endpoint này báo cáo trạng thái nhưng không lộ raw API keys hoặc 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" ``` Chạy API smoke test không cần credentials: ```bash npm run smoke:web-api ``` ## Storage, safety và resume AgInTiFlow lưu canonical sessions tập trung và chỉ giữ project-local pointers: | Location | Purpose | | --- | --- | | `~/.agintiflow/sessions//` | Canonical state, events, browser state, artifacts, snapshots, canvas files. | | `/.aginti-sessions/` | Project-local session pointers và Web UI database. Git ignored. | | `/.aginti/.env` | Optional project-local API keys với restricted permissions. Git ignored. | | `/AGINTI.md` | Editable project instructions và durable local preferences. Safe to commit nếu không chứa secrets. | Safety defaults: - Docker workspace mode là default CLI/Web bình thường cho coding và artifact generation. - File tools chặn secret-like paths, `.env`, `.git`, `node_modules` writes, absolute escapes, huge files và binary edits. - Shell commands được policy check; npm publish, npm token commands, sudo, destructive git và credential reads bị chặn. - File writes ghi hashes và compact diffs. - Tool calls và results được log vào structured session events. - Web và CLI dùng cùng session store, nên run có thể inspect và resume sau. Runtime notes chi tiết ở [../docs/runtime-modes-and-autonomy.md](../docs/runtime-modes-and-autonomy.md), [../docs/patch-tools.md](../docs/patch-tools.md) và [../docs/agent-runtime-pipe.md](../docs/agent-runtime-pipe.md). ## Cấu hình Biến môi trường thường dùng: ```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 tùy chọn và phải chọn rõ ràng; không bao giờ tự động fallback từ 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 ``` Chi tiết thêm: - [../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) ## Bản đồ tài liệu | Chủ đề | Liên kết | | --- | --- | | 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) | | Full older README reference | [../references/notes/readme-full-reference-2026-05-05.md](../references/notes/readme-full-reference-2026-05-05.md) | ## Phát triển Chạy từ source: ```bash git clone https://github.com/lazyingart/AgInTiFlow.git cd AgInTiFlow npm install npx playwright install chromium npm run check npm test ``` Khởi động local web từ source: ```bash npm run web # open http://127.0.0.1:3210 ``` Smoke checks hữu ích: ```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 dùng local mock provider trừ khi được đánh dấu rõ là real-provider tests. ## Ghi chú phát hành AgInTiFlow được phát hành dưới tên `@lazyingart/agintiflow`. Đường phát hành ưu tiên là GitHub Actions Trusted Publishing với npm provenance. Local token publishing chỉ là fallback cho bootstrapping và không bao giờ được commit `.env`, `.npmrc`, npm tokens, OTPs hoặc debug logs. Xem workflow phát hành đầy đủ tại [../docs/npm-publishing.md](../docs/npm-publishing.md). ## Hỗ trợ Nếu dự án này hữu ích, bạn có thể hỗ trợ phát triển tại đây: | 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 được phát triển bởi AgInTi Lab, LazyingArt LLC.