[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 agent للبحث والتطوير hybrid wet-dry، والذكاء المدرك للعتاد، وأتمتة البرمجيات، وسير العمل الصناعي. من تخطيط المختبر إلى تحليل البيانات، ومن التحكم بالعتاد إلى سكربتات الإنتاج، ومن microscopy والطائرات بدون طيار والروبوتات إلى التقارير، يساعد الوكلاء على العمل عبر API أو Web أو CLI مع إشراف SCS وسير عمل AAPS والتنفيذ المحمي والأدلة الدائمة. باختصار: شغّل `aginti` داخل مشروع، أعطه مهمة، افحص خطته، شاهد كل استدعاء أداة، استأنف لاحقاً، واحتفظ بالمخرجات داخل مساحة العمل. > **تنبيه حول حداثة الترجمة:** قد تتأخر هذه الترجمة عن بعض التفاصيل في [README الإنجليزي الحالي](../README.md) و[مرجع التشغيل المحلي أولاً](../docs/local-first-agent-runtime.md). الوضع الافتراضي هو LocalLLM على `http://127.0.0.1:8008/v1` مع `localllm-fast` و`localllm-deep`. مزودو الاستضافة ترقيات اختيارية وصريحة؛ لا تختارهم المفاتيح الموجودة في البيئة ولا يُستخدمون كـ 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 مبني على فلسفة مختلفة: | المبدأ | معناه عملياً | | --- | --- | | الذكاء المحلي يغير البنية | يستخدم الخط الأساسي بوابة LocalLLM الشقيقة للتخطيط والتنفيذ الخاصين محلياً، بينما تبقى النماذج المستضافة ترقيات صريحة. | | القابلية للفحص أفضل من الغموض | الخطط، استدعاءات الأدوات، file diffs، مخرجات الأوامر، canvas artifacts، وأحداث الجلسة تُحفظ ويمكن استئنافها. | | نماذج حسب الأدوار | route و main و spare و wrapper و auxiliary image أدوار منفصلة. يوفر LocalLLM مساري Fast وDeep الافتراضيين، بينما تتطلب DeepSeek وOpenAI وOpenRouter وQwen وVenice اختياراً صريحاً. | | Scouts قبل العمل الكبير | parallel scouts ترسم architecture و tests و risks و symbols و integration points بتكلفة قليلة قبل أن يعدّل المنفذ الرئيسي الملفات. | | SCS للعمل عالي المخاطر | Student-Committee-Supervisor يضيف بوابة typed: committee يضع المسودة، student يوافق/يراقب، supervisor ينفذ. استخدم `/scs` أو `--scs auto`. | | AAPS للـ workflows الكبيرة | AAPS يصف agentic pipeline scripts من الأعلى إلى الأسفل؛ ويمكن لـ AgInTiFlow أن يكون backend تفاعلياً للتحقق والترجمة والتنفيذ. | | أمان محلي افتراضي | Docker workspace، path guardrails، secret redaction، حظر أوامر npm publish/token، وسجلات مرئية تجعل الوكيل عملياً وغير معتم. | ## بداية سريعة ثبّت وافتح مشروعاً: ```bash npm install -g @lazyingart/agintiflow cd /path/to/your-project aginti init aginti ``` افتراضياً يتصل AgInTiFlow بخدمة LocalLLM الشقيقة على `http://127.0.0.1:8008/v1`، مستخدماً `localllm-fast` للـ route و`localllm-deep` للـ main، ولا يحتاج ذلك إلى مفتاح مستضاف. إذا أردت DeepSeek أو OpenAI أو OpenRouter أو Qwen أو Venice فاختر المزود صراحة وشغّل معالج auth. فشل LocalLLM يوقف التشغيل برسالة واضحة ولا يرسل المهمة إلى السحابة تلقائياً: ```bash aginti auth aginti auth deepseek aginti auth openrouter aginti auth venice aginti login grsai ``` حفظ مفتاح مستضاف يوفّر المصادقة فقط ولا يغيّر المزود النشط. وتبقى أدوات الصور المساعدة متوقفة حتى تستخدم `/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` | | حفظ مفاتيح providers | `aginti auth`, `/auth`, `/login` | | مراجعة 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` | | تفعيل shortcut لـ Venice | `/venice` | | توليد الصور | `/auxiliary image` ثم اطلب الصورة | | استئناف المشروع الحالي | `aginti resume` | | تصفح كل الجلسات | `aginti resume --all-sessions` | | إرسال queue إلى جلسة تعمل | `aginti queue "extra instruction"` | | تنظيف الجلسات الفارغة | `aginti --remove-empty-sessions` | | فحص القدرات | `aginti capabilities`, `aginti doctor --capabilities` | | مزامنة skills المراجعة | `aginti skillmesh status`, `aginti skillmesh sync` | | تحديث CLI | `aginti update` | الدردشة التفاعلية تدعم slash completion، selectors بأسهم Up/Down، إدخال متعدد الأسطر بـ `Ctrl+J`، سجل resume كامل، Markdown rendering، run status مرئي، رسائل ASAP pipe أثناء التشغيل، و interrupt/resume نظيف بـ `Ctrl+C`. الأوامر التفاعلية المثبتة تفحص npm أيضاً لوجود إصدار أحدث من AgInTiFlow وتعرض selector للتحديث/التخطي؛ أما 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 | نظرة عامة على Web app | | --- | --- | | AgInTiFlow CLI launch | AgInTiFlow web app overview | | عناصر التحكم بالمهمة | مخرجات runtime | | --- | --- | | AgInTiFlow task controls | AgInTiFlow runtime output | | سجل المحادثة | حالة sandbox | | --- | --- | | AgInTiFlow conversation history | AgInTiFlow sandbox status | | نظرة mobile | | --- | | AgInTiFlow mobile overview | لقطات التشغيل الأقدم محفوظة في source repository تحت [demos/archive/](https://github.com/lazyingart/AgInTiFlow/tree/main/demos/archive). ## القدرات الأساسية | القدرة | ما يقدمه AgInTiFlow | | --- | --- | | CLI agent workspace | دردشة terminal دائمة مع project cwd، session resume، حالة model/tool مرئية، وتلميحات أوامر واضحة. | | Local web workspace | Browser UI للجلسات، runtime logs، artifacts، model settings، project controls، canvas previews، وحالة sandbox. | | 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 مسارات صريحة، ولا يحدث fallback مستضاف بسبب المفاتيح المحيطة. | | Patch workflow | Codex-style patch envelopes، unified diffs، exact replacements، hashes، compact diffs، و path guardrails. | | Parallel scouts | استدعاءات scout اختيارية لـ architecture و implementation و review و tests و git flow و research و symbol tracing و dependency risk. | | SCS mode | Student-Committee-Supervisor quality gate اختياري للمهام المعقدة أو عالية المخاطر. | | AAPS adapter | تكامل اختياري مع `@lazyingart/aaps` لـ `.aaps` workflow init و validate و parse و compile و dry-run و run. | | Image generation | أدوات GRS AI وVenice متوقفة افتراضياً وتحتاج تفعيلاً صريحاً؛ حفظ المفتاح لا يفعّلها ولا يختار مزوداً بديلاً. | | Skill library | Markdown skills مدمجة للبرمجة، المواقع، Android/iOS، Python، Rust، Java، LaTeX، الكتابة، reviews، GitHub، AAPS والمزيد. | | Skill Mesh | تسجيل/مشاركة صارمة اختيارية لـ reusable skill packs تمت مراجعتها. إذا لم تستخدمها، يعمل AgInTiFlow طبيعياً دون background sharing. | | Multilingual UI | CLI والوثائق تدعم English و Japanese و Simplified/Traditional Chinese و Korean و French و Spanish و Arabic و Vietnamese و German و Russian. | ## النماذج والأدوار AgInTiFlow لا يتعامل مع “النموذج” كإعداد عالمي واحد. لديه أدوار: | الدور | الافتراضي | الغرض | | --- | --- | --- | | Route | `localllm/localllm-fast` | تخطيط محلي، triage، مهام قصيرة، وقرارات routing. | | Main | `localllm/localllm-deep` | منفذ محلي للـ coding المعقد وdebugging وwriting وresearch والمهام الطويلة. | | Spare | `localllm/localllm-deep` medium | مسار cross-check محلي؛ يتطلب spare مستضاف اختياراً صريحاً. | | Wrapper | `codex/gpt-5.5` medium | مستشار coding-agent خارجي اختياري. | | Auxiliary | `grsai/nano-banana-2` (off) | توليد صور وأدوات غير نصية بعد التفعيل الصريح فقط، بلا failover مبني على المفاتيح. | Selectors مفيدة: ```text /models /route /model /spare /wrapper /auxiliary model /venice ``` يمكن استخدام Venice للأعمال الإبداعية الاختيارية uncensored أو الأقل تقييداً. يبقى LocalLLM هو الوضع الافتراضي المحلي؛ وDeepSeek وبقية المزودين المستضافين ترقيات صريحة فقط. راجع [../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 و workflows الكبيرة AAPS هو طبقة pipeline-script؛ و AgInTiFlow هو 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 عندما تكون المهمة أكبر من دردشة واحدة: تطوير تطبيقات بمراحل، workflows للأبحاث/الكتب، validation gates، recovery steps، artifact production، أو top-down agentic scripts. راجع [../docs/aaps.md](../docs/aaps.md) والحزمة [https://www.npmjs.com/package/@lazyingart/aaps](https://www.npmjs.com/package/@lazyingart/aaps). ## مرجع سريع للـ Local API يعرض Web app APIs محلية للواجهة والأتمتة. هذه endpoints تعرض الحالة دون كشف 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" ``` شغّل API smoke test بلا credentials: ```bash npm run smoke:web-api ``` ## التخزين والأمان والاستئناف يخزن AgInTiFlow canonical sessions مركزياً ويحتفظ فقط بمؤشرات project-local: | الموقع | الغرض | | --- | --- | | `~/.agintiflow/sessions//` | canonical state، events، browser state، artifacts، snapshots، canvas files. | | `/.aginti-sessions/` | project-local session pointers و Web UI database. Ignored من git. | | `/.aginti/.env` | API keys اختيارية للمشروع بصلاحيات مقيدة. Ignored من git. | | `/AGINTI.md` | تعليمات مشروع قابلة للتحرير وتفضيلات محلية دائمة. آمن للـ commit إذا لم يحتوي أسراراً. | إعدادات الأمان الافتراضية: - Docker workspace mode هو default العادي للـ CLI/Web في coding عملي و artifact generation. - File tools تحظر secret-like paths و `.env` و `.git` و `node_modules` writes و absolute escapes و huge files و binary edits. - Shell commands تمر عبر policy checks؛ npm publish و npm token commands و sudo و destructive git و credential reads محظورة. - File writes تسجل hashes و compact diffs. - Tool calls والنتائج تُسجل في structured session events. - Web و CLI يستخدمان نفس session store، لذلك يمكن inspect/resume لأي run لاحقاً. ملاحظات 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 # ترقيات استضافة اختيارية وصريحة؛ ليست 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 ``` مفاتيح محلية للمشروع: ```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. ## ملاحظات الإصدار ينشر AgInTiFlow باسم `@lazyingart/agintiflow`. المسار المفضل للإصدار هو GitHub Actions Trusted Publishing مع npm provenance. النشر المحلي بالتوكن هو fallback للـ bootstrap فقط، ولا يجب أبداً commit ملفات `.env` أو `.npmrc` أو npm tokens أو OTPs أو debug logs. راجع [../docs/npm-publishing.md](../docs/npm-publishing.md) للـ release workflow الكامل. ## الدعم إذا كان هذا المشروع مفيداً، يمكنك دعم التطوير هنا: | الدعم | 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.