marimo
0.9.33
دفتر ملاحظات Python تفاعلي قابل للتكرار ومتوافق مع git وقابل للنشر كبرامج نصية أو تطبيقات.
المستندات · الخلاف · أمثلة
الإنجليزية |简体中文
Marimo عبارة عن دفتر ملاحظات تفاعلي بلغة Python: قم بتشغيل خلية أو التفاعل مع عنصر واجهة المستخدم، ويقوم Marimo تلقائيًا بتشغيل الخلايا التابعة (أو وضع علامة عليها على أنها قديمة)، مع الحفاظ على اتساق التعليمات البرمجية والمخرجات. يتم تخزين دفاتر ملاحظات ماريمو كلغة Python خالصة، وقابلة للتنفيذ كبرامج نصية، ويمكن نشرها كتطبيقات.
أبرز .
jupyter ، streamlit ، jupytext ، ipywidgets ، papermill ، والمزيد.py pip install marimo & & marimo tutorial introجرب ماريمو في ملعبنا عبر الإنترنت، والذي يعمل بالكامل في المتصفح!
انتقل إلى البداية السريعة للحصول على كتاب تمهيدي عن واجهة سطر الأوامر الخاصة بنا.
تضمن شركة Marimo اتساق رمز الكمبيوتر المحمول الخاص بك والمخرجات وحالة البرنامج. يؤدي هذا إلى حل العديد من المشكلات المرتبطة بأجهزة الكمبيوتر المحمولة التقليدية مثل Jupyter.
بيئة برمجة تفاعلية. قم بتشغيل خلية وسيتفاعل ماريمو عن طريق تشغيل الخلايا التي تشير إلى متغيراتها تلقائيًا، مما يؤدي إلى التخلص من المهمة المعرضة للأخطاء المتمثلة في إعادة تشغيل الخلايا يدويًا. احذف خلية وسيقوم ماريمو بمسح متغيراتها من ذاكرة البرنامج، مما يؤدي إلى إزالة الحالة المخفية.
متوافق مع أجهزة الكمبيوتر المحمولة باهظة الثمن. يتيح لك marimo تكوين وقت التشغيل ليكون كسولًا، مع وضع علامة على الخلايا المتأثرة على أنها قديمة بدلاً من تشغيلها تلقائيًا. يمنحك هذا ضمانات على حالة البرنامج مع منع التنفيذ العرضي للخلايا باهظة الثمن.
عناصر واجهة المستخدم المتزامنة. التفاعل مع عناصر واجهة المستخدم مثل أشرطة التمرير، والقوائم المنسدلة، ومحولات إطار البيانات، وواجهات الدردشة، ويتم إعادة تشغيل الخلايا التي تستخدمها تلقائيًا بأحدث قيمها.
أطر البيانات التفاعلية. يمكنك تصفح ملايين الصفوف والبحث فيها وتصفيتها وفرزها بسرعة مذهلة، دون الحاجة إلى تعليمات برمجية.
وقت التشغيل الأداء. يقوم Marimo بتشغيل تلك الخلايا التي تحتاج إلى تشغيل فقط من خلال التحليل الثابت للتعليمات البرمجية الخاصة بك.
تخفيض السعر الديناميكي وSQL. استخدم تخفيض السعر لإخبار القصص الديناميكية التي تعتمد على بيانات بايثون. أو قم بإنشاء استعلامات SQL تعتمد على قيم Python وتنفيذها على إطارات البيانات أو قواعد البيانات أو ملفات CSV أو جداول بيانات Google أو أي شيء آخر باستخدام محرك SQL المدمج لدينا، والذي يعرض النتيجة كإطار بيانات Python.
لا تزال دفاتر الملاحظات الخاصة بك تعتمد على لغة Python النقية، حتى لو كانت تستخدم تخفيض السعر أو SQL.
أمر التنفيذ الحتمي. يتم تنفيذ دفاتر الملاحظات بترتيب محدد، استنادًا إلى مراجع متغيرة بدلاً من مواضع الخلايا على الصفحة. قم بتنظيم دفاتر الملاحظات الخاصة بك لتناسب القصص التي ترغب في سردها بشكل أفضل.
إدارة الحزم المضمنة. يحتوي Marimo على دعم مدمج لجميع مديري الحزم الرئيسيين، مما يتيح لك تثبيت الحزم عند الاستيراد. يمكن لـ Marimo أيضًا إجراء تسلسل لمتطلبات الحزمة في ملفات الكمبيوتر المحمول، وتثبيتها تلقائيًا في صناديق حماية venv المعزولة.
البطاريات متضمنة. يأتي marimo مع GitHub Copilot، ومساعدي الذكاء الاصطناعي، وتنسيق كود Ruff، وتصدير HTML، وإكمال التعليمات البرمجية بسرعة، وملحق VS Code، وعارض بيانات تفاعلي، والعديد من ميزات جودة الحياة.
تثبيت. في المحطة، تشغيل
pip install marimo # or conda install -c conda-forge marimo
marimo tutorial introإنشاء دفاتر الملاحظات.
إنشاء أو تحرير دفاتر الملاحظات باستخدام
marimo editتشغيل التطبيقات. قم بتشغيل دفتر ملاحظاتك كتطبيق ويب، مع كود Python مخفي وغير قابل للتحرير:
marimo run your_notebook.pyتنفيذ كبرامج نصية. تنفيذ دفتر ملاحظات كبرنامج نصي في سطر الأوامر:
python your_notebook.pyتحويل دفاتر ملاحظات Jupyter تلقائيًا. قم بتحويل دفاتر ملاحظات Jupyter تلقائيًا إلى دفاتر ملاحظات Marimo باستخدام واجهة سطر الأوامر (CLI).
marimo convert your_notebook.ipynb > your_notebook.pyأو استخدم واجهة الويب الخاصة بنا.
دروس. قائمة بجميع الدروس:
marimo tutorial --helpراجع الأسئلة الشائعة في مستنداتنا.
من السهل البدء باستخدام ماريمو، مع وجود مساحة كبيرة للمستخدمين المتميزين. على سبيل المثال، إليك مصور التضمين الذي تم إنشاؤه باستخدام ماريمو (فيديو):
تحقق من مستنداتنا examples/ المجلد ومعرضنا لمعرفة المزيد.
| درس تعليمي | المدخلات | المؤامرات | تَخطِيط |
نحن نقدر كل المساهمات! لا تحتاج إلى أن تكون خبيرًا للمساعدة. يرجى الاطلاع على CONTRIBUTING.md لمزيد من التفاصيل حول كيفية البدء.
أسئلة؟ تواصل معنا على الديسكورد.
نحن نبني المجتمع. تعال شنق معنا!
يعد marimo بمثابة إعادة اختراع لدفتر Python باعتباره برنامج Python قابلاً للتكرار وتفاعليًا وقابلاً للمشاركة، بدلاً من لوحة مسودة JSON المعرضة للأخطاء.
نحن نؤمن بأن الأدوات التي نستخدمها تشكل الطريقة التي نفكر بها - أدوات أفضل، من أجل عقول أفضل. مع ماريمو، نأمل أن نوفر لمجتمع بايثون بيئة برمجة أفضل لإجراء الأبحاث وإيصالها؛ لتجربة التعليمات البرمجية ومشاركتها؛ لتعلم العلوم الحسابية وتدريسها.
يأتي إلهامنا من العديد من الأماكن والمشاريع، وخاصة مقالات Pluto.jl وObservableHQ ومقالات بريت فيكتور. يعد ماريمو جزءًا من حركة أكبر نحو برمجة تدفق البيانات التفاعلية. من IPyflow وstreamlit وTensorFlow وPyTorch وJAX وReact، تعمل أفكار البرمجة الوظيفية والتعريفية والتفاعلية على تحويل مجموعة واسعة من الأدوات نحو الأفضل.
