Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

i18n: review Arabic and Hindi READMEs against current English (#87)

A. Sam Mohammad44e27c48e79f
diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md
index a314ae8..f75588a 100644
--- a/docs/i18n/README.ar.md
+++ b/docs/i18n/README.ar.md
@@ -1,6 +1,6 @@
<div align="center">
-<img src="../../assets/logo.svg" alt="AEC Model Bridge logo: an isometric model cube with a bridge arch" height="120">
+<img src="../../assets/logo.svg" alt="شعار AEC Model Bridge: مكعب نموذج أيزومتري يعلوه قوس جسر" height="120">
[English](../../README.md) | [简体中文](README.zh-CN.md) | [Español](README.es.md) | [हिन्दी](README.hi.md) | **العربية** | [Português (BR)](README.pt-BR.md) | [Русский](README.ru.md) | [日本語](README.ja.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Bahasa Indonesia](README.id.md) | [Türkçe](README.tr.md) | [한국어](README.ko.md) | [Tiếng Việt](README.vi.md) | [Italiano](README.it.md) | [Polski](README.pl.md) | [繁體中文](README.zh-TW.md)
@@ -26,10 +26,16 @@
<div dir="rtl">
<p align="center">
- <img src="../images/readme/demo.gif" alt="عرض توضيحي: يعثر مساعد الذكاء الاصطناعي على 12 بابًا بلا Mark ويُعدّ خطة. تنتظر الخطة في لوحة Revit حتى توافق عليها، ثم تُقرأ القيم للتحقق منها. قيم تجريبية وجلسة محاكاة." width="900">
+ <img src="../images/readme/demo.gif" alt="عرض توضيحي: يظهر نموذج ثلاثي الأبعاد لمبنى بجانب لوحة Revit. يعثر مساعد الذكاء الاصطناعي على 12 بابًا بلا Mark ويُعدّ خطة. تنتظر الخطة في لوحة Revit حتى توافق عليها، ثم تُقرأ القيم للتحقق منها. القيم أمثلة توضيحية والجلسة محاكاة." width="900">
</p>
-اربط Claude أو Codex أو أي عميل MCP آخر بنموذج Revit المفتوح لديك. يجمع AEC Model Bridge بين خادم MCP مكتوب بلغة Python وإضافة Revit أصلية: الأدوات للقراءة فقط تفحص النموذج فورًا، أما أي تغيير في النموذج فيتطلب افتراضيًا خطة معتمدة. [اطّلع على آلية الموافقة](#كيف-تعمل-الموافقة).
+AEC Model Bridge هو خادم MCP مفتوح المصدر لبرنامج Revit، يتيح لـ Claude وCodex وCursor وغيرها من مساعدي الذكاء الاصطناعي قراءة نموذج Revit المفتوح لديك وتعديله، على أن توافق أنت أولًا على كل تغيير. يجمع بين خادم MCP مكتوب بلغة Python وإضافة Revit أصلية: تفحص الأدوات المخصصة للقراءة فقط النموذج فورًا، أما أي تغيير في النموذج فيتطلب افتراضيًا خطة معتمدة. [اطّلع على آلية الموافقة](#كيف-تعمل-الموافقة).
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="يعمل مع: إعداد Claude Desktop وVS Code مع GitHub Copilot وCursor وCodex موثّق. ويُتوقع أن تعمل عملاء MCP الأخرى أيضًا، مثل Claude Code وWindsurf وCline وContinue وZed وGemini CLI. التطبيقات: Revit من 2024 إلى 2027، وRhino، وGrasshopper، وNavisworks (قيد التطوير). البيانات: IFC وSpeckle وExcel وSQLite. البروتوكول: MCP عبر stdio مع بوابة موافقة." width="900">
+</p>
+
+إعداد الاتصال موثّق لـ Claude Desktop وVS Code مع GitHub Copilot وCursor وCodex. وبما أنه خادم MCP قياسي يعمل عبر stdio، فمن المتوقع أن تعمل معه عملاء أخرى مثل Claude Code وWindsurf وCline وContinue وZed وGemini CLI. راجع [التوافق](../compatibility.md) لمعرفة ما هو موثّق وما لم يُختبر بعد.
يتضمن الخادم نفسه فحص ملفات IFC وأتمتة Rhino وGrasshopper والتكامل مع Speckle. يبيّن [حالة التكاملات](#تكاملات-أخرى) المزوّدات المتاحة وتلك التي ما زالت قيد التطوير.
@@ -39,10 +45,10 @@
| سير العمل | مثال على الطلب | الأدوات المستخدمة |
| --- | --- | --- |
-| مراجعة النموذج | "اعرض المستند النشط، وأدرج تحذيراته، وابحث عن العناصر المتأثرة." | `revit_get_document_info`, `revit_get_warnings`, `revit_get_elements_by_type` |
-| تحديث المعاملات | "ابحث عن الجدران في Level 02، واعرض قيم Comments الخاصة بها، واقترح تحديثًا دفعيًا." | `revit_get_elements_by_type`, `revit_get_element_parameters`, `revit_batch_set_parameters` |
-| إنتاج المخططات | "جهّز قائمة لوحات (sheets) من ملف CSV هذا، ثم اقترح إنشاء اللوحات ووضع المناظير (views)." | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
-| مراجعة IFC | "اعرض طوابق ملف IFC هذا، وافحص خصائص الجدران، وأبلغ عن مشكلات التحقق من المخطط." | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
+| مراجعة النموذج | "اعرض المستند النشط، وأدرج تحذيراته، وابحث عن العناصر المتأثرة." | `revit_get_document_info`، `revit_get_warnings`، `revit_get_elements_by_type` |
+| تحديث المعاملات | "ابحث عن الجدران في Level 02، واعرض قيم Comments الخاصة بها، واقترح تحديثًا دفعيًا." | `revit_get_elements_by_type`، `revit_get_element_parameters`، `revit_batch_set_parameters` |
+| إنتاج المخططات | "جهّز قائمة لوحات (sheets) من ملف CSV هذا، ثم اقترح إنشاء اللوحات ووضع المناظير (views)." | `revit_batch_create_sheets_from_csv`، `revit_place_viewport_on_sheet` |
+| مراجعة IFC | "اعرض طوابق ملف IFC هذا، وافحص خصائص الجدران، وأبلغ عن مشكلات التحقق من المخطط." | `ifc_get_spatial_structure`، `ifc_get_properties`، `ifc_validate` |
لتجربة أولى داخل Revit، جرّب ما يلي:
@@ -141,29 +147,29 @@ the plan in Revit, apply it and read the values back to confirm the result.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../images/architecture-dark.png">
- <img src="../images/architecture-light.png" alt="Architecture of AEC Model Bridge: an MCP client such as Claude or Codex calls the Python MCP hub, which routes tool calls to the Revit, Rhino, Navisworks, IFC and Speckle providers. The Revit and Rhino providers talk to add-ins over localhost HTTP, the IFC provider reads IFC files with IfcOpenShell, and Navisworks is still in progress." width="900">
+ <img src="../images/architecture-light.png" alt="بنية AEC Model Bridge: يستدعي عميل MCP، مثل Claude أو Codex، موزّع MCP المكتوب بلغة Python، فيوجّه الموزّع استدعاءات الأدوات إلى مزوّدات Revit وRhino وNavisworks وIFC وSpeckle. يتصل مزوّدا Revit وRhino بالإضافات عبر HTTP على localhost، ويقرأ مزوّد IFC ملفات IFC باستخدام IfcOpenShell، أما Navisworks فما زال قيد التطوير." width="900">
</picture>
</p>
<sub>مصدر المخطط: [architecture.mmd](../diagrams/architecture.mmd). أعد توليد الصور بالأمر `python scripts/render_diagrams.py`.</sub>
-الصناديق ذات اللون الأخضر المزرق تعمل اليوم. الصناديق ذات الحدود المتقطعة بلون العنبر قيد التطوير. أما الأشكال النيلية فهي البيانات والخدمات الخارجية.
+المربعات ذات اللون الأخضر المزرق تعمل اليوم. المربعات ذات الحدود المتقطعة بلون العنبر قيد التطوير. أما الأشكال النيلية فتمثّل البيانات والخدمات الخارجية.
### كيف تعمل الموافقة
-يوقف الموزّع أي استدعاء لأداة يغيّر النموذج ما لم يحمل خطة معتمدة. الوضع الافتراضي هو `required`. يقترح الذكاء الاصطناعي خطة، وتراجعها أنت في اللوحة الجانبية في Revit، ثم تنفّذها الإضافة على الخيط الرئيسي في Revit ضمن معاملة (transaction) مسمّاة.
+يوقف الموزّع أي استدعاء لأداة يغيّر النموذج ما لم يحمل خطة معتمدة. الوضع الافتراضي هو `required`. يقترح الذكاء الاصطناعي خطة، وتراجعها أنت في اللوحة الجانبية في Revit، ثم تنفّذها الإضافة على الخيط الرئيسي (main thread) في Revit ضمن معاملة (transaction) مسمّاة.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-dark.png">
- <img src="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-light.png" alt="Inspect, Propose, Approve, Verify. Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative." width="900">
+ <img src="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-light.png" alt="فحص، اقتراح، موافقة، تحقق. أربع خطوات: يعثر الفحص على قيمة Mark فارغة، ويصوغ الاقتراح تغييرًا، والموافقة قرار بشري، ويقرأ التحقق القيمة مجددًا. القيم المعروضة أمثلة توضيحية." width="900">
</picture>
</p>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../images/approval-flow-dark.png">
- <img src="../images/approval-flow-light.png" alt="Approval flow: the AI assistant proposes a plan, the MCP hub and ApprovalGate show it in the Revit side panel, and only after you approve does execute_plan forward the commands to the Revit add-in, which runs them in one named transaction. If you reject or never approve, the call is blocked and the model stays untouched." width="900">
+ <img src="../images/approval-flow-light.png" alt="مخطط تدفق الموافقة: يقترح مساعد الذكاء الاصطناعي خطة، ويعرضها موزّع MCP وApprovalGate في اللوحة الجانبية في Revit، ولا يمرّر execute_plan الأوامر إلى إضافة Revit، التي تنفّذها في معاملة مسمّاة واحدة، إلا بعد موافقتك. وإذا رفضتَ أو لم توافق أبدًا، يُحجب الاستدعاء ويبقى النموذج دون أي تغيير." width="900">
</picture>
</p>
@@ -171,7 +177,7 @@ the plan in Revit, apply it and read the values back to confirm the result.
إذا اعتُمدت خطة ثم تبيّن لاحقًا أنها خاطئة، فإن `rollback_plan` يعكسها. يستخدم التراجع أمر Undo في Revit ضمن الجلسة نفسها أو القيم العكسية للمعاملات. أما العمليات التي لا يمكن عكسها، مثل كتابة الملفات، فتطلب تأكيدًا ثانيًا. دورة الحياة موضحة في [ADR 0008](../0008-approval-gate-lifecycle.md).
-لخطوط المعالجة غير المراقبة يمكنك ضبط `MCP_REVIT_APPROVAL_MODE=auto`. يؤدي ذلك إلى إيقاف المراجعة البشرية، لذا استخدمه في بيئة خاضعة للتحكم فقط.
+في خطوط المعالجة الآلية غير المراقَبة يمكنك ضبط `MCP_REVIT_APPROVAL_MODE=auto`. يؤدي ذلك إلى إيقاف المراجعة البشرية، لذا استخدمه في بيئة خاضعة للتحكم فقط.
## إصدارات Revit المدعومة
@@ -196,6 +202,8 @@ the plan in Revit, apply it and read the values back to confirm the result.
| Power BI | قيد التطوير. المزوّد والأداة موجودان لكنهما غير مسجّلين في الموزّع. |
| Excel وParquet وDuckDB | مخطط له. |
+أسماء المنتجات والشعارات مملوكة لأصحابها. تُستخدم في اللافتة العلوية فقط لبيان ما يعمل معه هذا المشروع.
+
## تثبيت إضافة Revit
**الأسهل (Windows):** نزّل `AECModelBridge-Setup-<version>.exe` من [أحدث إصدار](https://github.com/Sam-AEC/aec-model-bridge/releases/latest)، وانقر عليه نقرًا مزدوجًا، واختر إصدارات Revit لديك، ثم أعد تشغيل Revit. يثبّت الإضافة وخادم Python المرفق، وإذا حددت الخيار فيثبّت أيضًا إعدادات Claude Desktop وVS Code مع نسخة احتياطية من إعداداتك الحالية. يمكنك إلغاء التثبيت من إعدادات Windows. الخطوات أدناه مخصصة للبناء من المصدر.
@@ -264,7 +272,7 @@ C:\ProgramData\AECModelBridge\bin\<year>
<div dir="rtl">
-يتضمن كل [إصدار على GitHub](https://github.com/Sam-AEC/aec-model-bridge/releases/latest) حزمة جاهزة لكل سنة من Revit، مثل `aec-model-bridge-revit-2026-<version>.zip`. فك ضغطها ثم شغّل `.\install.ps1 -RevitVersion 2026` بدلًا من البناء من المصدر. ولإنشاء مثبّت Windows بنقرة مزدوجة، يبنيه السكربت `scripts/build-installer.ps1` باستخدام Inno Setup. الدليل الكامل، مع استكشاف الأخطاء، في [docs/install.md](../install.md).
+يتضمن كل [إصدار على GitHub](https://github.com/Sam-AEC/aec-model-bridge/releases/latest) حزمة جاهزة لكل سنة من Revit، مثل `aec-model-bridge-revit-2026-<version>.zip`. فك ضغطها ثم شغّل `.\install.ps1 -RevitVersion 2026` بدلًا من البناء من المصدر. ولإنشاء مثبّت Windows بنقرة مزدوجة، يبنيه السكربت `scripts/build-installer.ps1` باستخدام Inno Setup. الدليل الكامل، مع استكشاف الأخطاء وإصلاحها، في [docs/install.md](../install.md).
## ربط Claude Desktop بـ Revit
@@ -327,7 +335,7 @@ Invoke-RestMethod "$($switch.endpoint)/health"
- يستمع جسر Revit على localhost فقط.
- يقرأ الخادم ويكتب داخل المجلدات المذكورة في `MCP_REVIT_ALLOWED_DIRECTORIES` فقط.
- تحتاج الأدوات التي تغيّر النموذج إلى خطة معتمدة ما لم توقف الموافقة.
-- تُسجَّل استدعاءات الأدوات في سجل تدقيق، وتُحجب الأسرار.
+- تُسجَّل استدعاءات الأدوات في سجل تدقيق، وتُخفى القيم السرية.
التفاصيل في [docs/security.md](../security.md). للإبلاغ عن ثغرة أمنية، اتبع [SECURITY.md](../../SECURITY.md).
@@ -339,7 +347,7 @@ Invoke-RestMethod "$($switch.endpoint)/health"
### ما مساعدو الذكاء الاصطناعي الذين يعملون معه؟
-أي عميل MCP قادر على تشغيل خادم stdio محلي. نوثّق Claude Desktop وVS Code مع GitHub Copilot والعملاء الذين يقرؤون إعداد `mcpServers` القياسي. ويمكن لمحادثة اللوحة أيضًا استخدام مفتاح Anthropic API أو أداتي سطر الأوامر `claude` أو `codex` إذا كانتا مثبّتتين. راجع [ADR 0012](../0012-native-agent-chat-backend.md).
+أي عميل MCP قادر على تشغيل خادم stdio محلي. نوثّق إعداد Claude Desktop وVS Code مع GitHub Copilot وCursor وCodex، والعملاء الذين يقرؤون إعداد `mcpServers` القياسي. ويُتوقع أن تعمل Windsurf وCline وRoo Code وContinue وZed وClaude Code وGemini CLI بالطريقة نفسها، لكنها لم تُختبر. راجع [التوافق](../compatibility.md). ويمكن لمحادثة اللوحة أيضًا استخدام مفتاح Anthropic API أو أداتي سطر الأوامر `claude` أو `codex` إذا كانتا مثبّتتين. راجع [ADR 0012](../0012-native-agent-chat-backend.md).
### هل يستطيع الذكاء الاصطناعي تغيير نموذجي دون أن يسأل؟
@@ -359,7 +367,7 @@ Invoke-RestMethod "$($switch.endpoint)/health"
## الإصدارات والنسخ
-يتبع AEC Model Bridge نظام الإصدارات الدلالي. توسم الإصدارات على GitHub بالصيغة `vX.Y.Z`، ويحمل ملف `VERSION` في الجذر رقم الإصدار. راجع [docs/versioning.md](../versioning.md) لعملية الإصدار، و[CHANGELOG.md](../../CHANGELOG.md) لما تغيّر في كل إصدار.
+يتبع AEC Model Bridge نظام الإصدارات الدلالي. تُوسَم الإصدارات على GitHub بالصيغة `vX.Y.Z`، ويحتوي ملف `VERSION` في الجذر على رقم الإصدار. راجع [docs/versioning.md](../versioning.md) لعملية الإصدار، و[CHANGELOG.md](../../CHANGELOG.md) لما تغيّر في كل إصدار.
## التطوير
diff --git a/docs/i18n/README.hi.md b/docs/i18n/README.hi.md
index 81c10f0..5eb406a 100644
--- a/docs/i18n/README.hi.md
+++ b/docs/i18n/README.hi.md
@@ -1,6 +1,6 @@
<div align="center">
-<img src="../../assets/logo.svg" alt="AEC Model Bridge logo: an isometric model cube with a bridge arch" height="120">
+<img src="../../assets/logo.svg" alt="AEC Model Bridge का लोगो: ब्रिज आर्च वाला आइसोमेट्रिक मॉडल क्यूब" height="120">
[English](../../README.md) | [简体中文](README.zh-CN.md) | [Español](README.es.md) | **हिन्दी** | [العربية](README.ar.md) | [Português (BR)](README.pt-BR.md) | [Русский](README.ru.md) | [日本語](README.ja.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Bahasa Indonesia](README.id.md) | [Türkçe](README.tr.md) | [한국어](README.ko.md) | [Tiếng Việt](README.vi.md) | [Italiano](README.it.md) | [Polski](README.pl.md) | [繁體中文](README.zh-TW.md)
@@ -20,10 +20,16 @@ Revit 2024 – 2027 के लिए ओपन-सोर्स MCP सर्व
</div>
<p align="center">
- <img src="../images/readme/demo.gif" alt="डेमो: AI असिस्टेंट बिना Mark वाले 12 दरवाज़े ढूँढता है और एक योजना बनाता है। योजना Revit पैनल में आपकी मंज़ूरी का इंतज़ार करती है, फिर मान वापस पढ़कर जाँचे जाते हैं। उदाहरण के मान, नकली सत्र।" width="900">
+ <img src="../images/readme/demo.gif" alt="डेमो: किसी इमारत का 3D मॉडल Revit पैनल के बगल में दिखता है। AI असिस्टेंट बिना Mark वाले 12 दरवाज़े ढूँढता है और एक योजना बनाता है। योजना Revit पैनल में आपकी मंज़ूरी का इंतज़ार करती है, फिर मान वापस पढ़कर जाँचे जाते हैं। मान उदाहरण के लिए हैं और सत्र सिम्युलेटेड है।" width="900">
</p>
-Claude, Codex या किसी अन्य MCP क्लाइंट को अपने खुले Revit मॉडल से जोड़ें। AEC Model Bridge में Python MCP सर्वर और नेटिव Revit ऐड-इन साथ आते हैं: रीड-ओनली टूल मॉडल को तुरंत जाँच लेते हैं, और मॉडल में किसी भी बदलाव के लिए डिफ़ॉल्ट रूप से मंज़ूर की हुई योजना ज़रूरी है। [मंज़ूरी की प्रक्रिया देखें](#मंज़ूरी-कैसे-काम-करती-है)।
+AEC Model Bridge ओपन-सोर्स Revit MCP सर्वर है, जिससे Claude, Codex, Cursor और अन्य AI असिस्टेंट आपके खुले Revit मॉडल को पढ़ और बदल सकते हैं, और हर बदलाव पहले आपकी मंज़ूरी से गुज़रता है। इसमें Python MCP सर्वर और नेटिव Revit ऐड-इन साथ आते हैं: रीड-ओनली टूल मॉडल को तुरंत जाँच लेते हैं, और मॉडल में किसी भी बदलाव के लिए डिफ़ॉल्ट रूप से मंज़ूर की हुई योजना ज़रूरी है। [मंज़ूरी की प्रक्रिया देखें](#मंज़ूरी-कैसे-काम-करती-है)।
+
+<p align="center">
+ <img src="../images/readme/works-with.svg" alt="इनके साथ काम करता है: Claude Desktop, GitHub Copilot वाले VS Code, Cursor और Codex के लिए सेटअप दस्तावेज़ में दिया गया है। Claude Code, Windsurf, Cline, Continue, Zed और Gemini CLI जैसे अन्य MCP क्लाइंट भी काम करने चाहिए। एप्लिकेशन: Revit 2024 से 2027, Rhino, Grasshopper, Navisworks (विकास जारी)। डेटा: IFC, Speckle, Excel, SQLite। प्रोटोकॉल: मंज़ूरी गेट के साथ stdio पर MCP।" width="900">
+</p>
+
+सेटअप Claude Desktop, GitHub Copilot वाले VS Code, Cursor और Codex के लिए दस्तावेज़ में दिया गया है। यह एक मानक MCP stdio सर्वर है, इसलिए Claude Code, Windsurf, Cline, Continue, Zed और Gemini CLI जैसे अन्य क्लाइंट भी काम करने चाहिए। क्या दस्तावेज़ में है और क्या अभी परखा नहीं गया, यह जानने के लिए [संगतता](../compatibility.md) देखें।
इसी सर्वर में IFC जाँच, Rhino और Grasshopper ऑटोमेशन तथा Speckle इंटीग्रेशन भी शामिल हैं। [इंटीग्रेशन की स्थिति](#अन्य-इंटीग्रेशन) बताती है कि कौन-से प्रोवाइडर उपलब्ध हैं और कौन-से अभी बन रहे हैं।
@@ -36,7 +42,7 @@ BIM समन्वयकों के लिए: मॉडल की गुण
| मॉडल समीक्षा | "सक्रिय दस्तावेज़ दिखाओ, उसकी चेतावनियाँ सूचीबद्ध करो और प्रभावित एलिमेंट खोजो।" | `revit_get_document_info`, `revit_get_warnings`, `revit_get_elements_by_type` |
| पैरामीटर अपडेट | "Level 02 की दीवारें खोजो, उनके Comments के मान दिखाओ और बैच अपडेट का प्रस्ताव दो।" | `revit_get_elements_by_type`, `revit_get_element_parameters`, `revit_batch_set_parameters` |
| ड्रॉइंग तैयार करना | "इस CSV से शीट सूची तैयार करो, फिर शीट बनाने और व्यू रखने का प्रस्ताव दो।" | `revit_batch_create_sheets_from_csv`, `revit_place_viewport_on_sheet` |
-| IFC समीक्षा | "इस IFC फ़ाइल की मंज़िलें दिखाओ, दीवारों के प्रॉपर्टी जाँचो और स्कीमा वैलिडेशन की समस्याएँ बताओ।" | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
+| IFC समीक्षा | "इस IFC फ़ाइल की मंज़िलें दिखाओ, दीवारों की प्रॉपर्टी जाँचो और स्कीमा वैलिडेशन की समस्याएँ बताओ।" | `ifc_get_spatial_structure`, `ifc_get_properties`, `ifc_validate` |
Revit में पहली बार आज़माने के लिए, यह लिखें:
@@ -55,7 +61,7 @@ the plan in Revit, apply it and read the values back to confirm the result.
बदलावों के लिए असिस्टेंट `plan_actions` से योजना बनाता है; `execute_plan` उसे लागू करे, इससे पहले आप Revit पैनल में उसकी समीक्षा करते हैं। IFC समीक्षा Revit के बिना चलती है।
-स्नैपशॉट आधारित QA/QC और रिपोर्ट मॉड्यूल के लिए एक संगत सेव किया हुआ स्नैपशॉट ज़रूरी है। फ़िलहाल Revit से मॉड्यूल तक स्नैपशॉट पहुँचाने में फ़ाइल नाम और वर्कस्पेस का मेल होना ज़रूरी है; `snapshot_id` छोड़ने पर बनाया हुआ नमूना डेटा लौट सकता है। लाइव जाँच के लिए ऊपर दिए Revit टूल सीधे इस्तेमाल करें। [प्रस्तावित सुधार और डेमो](../roadmap.md)।
+स्नैपशॉट आधारित QA/QC और रिपोर्ट मॉड्यूल के लिए एक संगत सेव किया हुआ स्नैपशॉट ज़रूरी है। फ़िलहाल Revit से मॉड्यूल तक स्नैपशॉट पहुँचाने में फ़ाइल नाम और वर्कस्पेस का मेल होना ज़रूरी है; `snapshot_id` छोड़ने पर बनाया हुआ नमूना डेटा लौट सकता है। लाइव जाँच के लिए ऊपर दिए Revit टूल सीधे इस्तेमाल करें। [नियोजित सुधार और डेमो](../roadmap.md)।
## क्विक स्टार्ट
@@ -123,7 +129,7 @@ MCP क्लाइंट एक Python हब से बात करता ह
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../images/architecture-dark.png">
- <img src="../images/architecture-light.png" alt="Architecture of AEC Model Bridge: an MCP client such as Claude or Codex calls the Python MCP hub, which routes tool calls to the Revit, Rhino, Navisworks, IFC and Speckle providers. The Revit and Rhino providers talk to add-ins over localhost HTTP, the IFC provider reads IFC files with IfcOpenShell, and Navisworks is still in progress." width="900">
+ <img src="../images/architecture-light.png" alt="AEC Model Bridge का आर्किटेक्चर: Claude या Codex जैसा MCP क्लाइंट Python MCP हब को कॉल करता है, जो टूल कॉल को Revit, Rhino, Navisworks, IFC और Speckle प्रोवाइडर तक पहुँचाता है। Revit और Rhino प्रोवाइडर localhost HTTP के ज़रिए ऐड-इन से बात करते हैं, IFC प्रोवाइडर IfcOpenShell से IFC फ़ाइलें पढ़ता है, और Navisworks अभी विकास में है।" width="900">
</picture>
</p>
@@ -138,14 +144,14 @@ MCP क्लाइंट एक Python हब से बात करता ह
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-dark.png">
- <img src="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-light.png" alt="Inspect, Propose, Approve, Verify. Four steps: inspect finds an empty Mark, propose drafts a change, approve is a human decision, verify reads the value back. Example values are illustrative." width="900">
+ <img src="https://raw.githubusercontent.com/Sam-AEC/aec-model-bridge/main/docs/images/readme/readme-workflow-light.png" alt="जाँचें, प्रस्ताव दें, मंज़ूर करें, सत्यापित करें। चार चरण: जाँच में खाली Mark मिलता है, प्रस्ताव में बदलाव का मसौदा बनता है, मंज़ूरी इंसान का फ़ैसला है, और सत्यापन में मान वापस पढ़ा जाता है। दिखाए गए मान उदाहरण के लिए हैं।" width="900">
</picture>
</p>
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="../images/approval-flow-dark.png">
- <img src="../images/approval-flow-light.png" alt="Approval flow: the AI assistant proposes a plan, the MCP hub and ApprovalGate show it in the Revit side panel, and only after you approve does execute_plan forward the commands to the Revit add-in, which runs them in one named transaction. If you reject or never approve, the call is blocked and the model stays untouched." width="900">
+ <img src="../images/approval-flow-light.png" alt="मंज़ूरी का प्रवाह: AI असिस्टेंट योजना सुझाता है, MCP हब और ApprovalGate उसे Revit साइड पैनल में दिखाते हैं, और आपकी मंज़ूरी के बाद ही execute_plan कमांड को Revit ऐड-इन तक भेजता है, जो उन्हें एक नामित ट्रांज़ैक्शन में चलाता है। अगर आप अस्वीकार करें या कभी मंज़ूर न करें, तो कॉल रुक जाती है और मॉडल अछूता रहता है।" width="900">
</picture>
</p>
@@ -153,7 +159,7 @@ MCP क्लाइंट एक Python हब से बात करता ह
अगर मंज़ूर की गई योजना बाद में ग़लत निकले, तो `rollback_plan` उसे पलट देता है। रोलबैक उसी सेशन में Revit Undo या उलटे पैरामीटर मानों का इस्तेमाल करता है। जिन ऑपरेशनों को पलटा नहीं जा सकता, जैसे फ़ाइल आउटपुट, उनके लिए दूसरी बार पुष्टि माँगी जाती है। पूरा जीवनचक्र [ADR 0008](../0008-approval-gate-lifecycle.md) में है।
-बिना निगरानी वाली पाइपलाइनों के लिए आप `MCP_REVIT_APPROVAL_MODE=auto` सेट कर सकते हैं। इससे इंसानी जाँच बंद हो जाती है, इसलिए इसे सिर्फ़ नियंत्रित वातावरण में इस्तेमाल करें।
+बिना निगरानी वाली पाइपलाइनों के लिए आप `MCP_REVIT_APPROVAL_MODE=auto` सेट कर सकते हैं। इससे इंसान द्वारा की जाने वाली जाँच बंद हो जाती है, इसलिए इसे सिर्फ़ नियंत्रित एनवायरनमेंट में इस्तेमाल करें।
## समर्थित Revit वर्ज़न
@@ -176,7 +182,9 @@ MCP क्लाइंट एक Python हब से बात करता ह
| Speckle | उपलब्ध। आपके एनवायरनमेंट में Speckle क्लाइंट ID चाहिए। |
| Navisworks Manage | विकास जारी। प्रोवाइडर और उसके टूल रजिस्टर हैं। Navisworks ऐड-इन अधूरा है। |
| Power BI | विकास जारी। प्रोवाइडर और टूल मौजूद हैं, पर हब में रजिस्टर नहीं हैं। |
-| Excel, Parquet और DuckDB | योजना में। |
+| Excel, Parquet और DuckDB | नियोजित। |
+
+उत्पादों के नाम और लोगो उनके मालिकों के हैं। बैनर में इनका उपयोग सिर्फ़ यह दिखाने के लिए है कि यह प्रोजेक्ट किनके साथ काम करता है।
## Revit ऐड-इन इंस्टॉल करें
@@ -212,7 +220,7 @@ $RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"
C:\ProgramData\AECModelBridge\bin\<year>
```
-ऐड-इन मैनिफ़ेस्ट प्रति उपयोगकर्ता यहाँ इंस्टॉल होता है:
+ऐड-इन मैनिफ़ेस्ट हर उपयोगकर्ता के लिए अलग से यहाँ इंस्टॉल होता है:
```text
%APPDATA%\Autodesk\Revit\Addins\<year>
@@ -293,7 +301,7 @@ Model Context Protocol (MCP) एक ओपन स्टैंडर्ड है
### कौन-से AI असिस्टेंट इसके साथ काम करते हैं?
-कोई भी MCP क्लाइंट जो लोकल stdio सर्वर शुरू कर सके। हमने Claude Desktop, GitHub Copilot वाले VS Code, और मानक `mcpServers` कॉन्फ़िगरेशन पढ़ने वाले क्लाइंट के लिए दस्तावेज़ दिए हैं। पैनल चैट Anthropic API कुंजी, या इंस्टॉल होने पर `claude` या `codex` कमांड-लाइन टूल भी इस्तेमाल कर सकती है। [ADR 0012](../0012-native-agent-chat-backend.md) देखें।
+कोई भी MCP क्लाइंट जो लोकल stdio सर्वर शुरू कर सके। हमने Claude Desktop, GitHub Copilot वाले VS Code, Cursor और Codex, तथा मानक `mcpServers` कॉन्फ़िगरेशन पढ़ने वाले क्लाइंट के सेटअप का दस्तावेज़ तैयार किया है। Windsurf, Cline, Roo Code, Continue, Zed, Claude Code और Gemini CLI को भी इसी तरह काम करना चाहिए, पर इन्हें परखा नहीं गया है। [संगतता](../compatibility.md) देखें। पैनल चैट Anthropic API कुंजी, या इंस्टॉल होने पर `claude` या `codex` कमांड-लाइन टूल भी इस्तेमाल कर सकती है। [ADR 0012](../0012-native-agent-chat-backend.md) देखें।
### क्या AI बिना पूछे मेरा मॉडल बदल सकता है?