عن المشروع

Mobilerun هو إطار مفتوح المصدر يسمح للوكلاء ذوي النماذج الكبيرة بالتحكم في أجهزة Android و iOS باستخدام أوامر اللغة الطبيعية. إنه محايد من حيث النموذج، ويدعم موفرين مثل OpenAI و Anthropic و Gemini و xAI و Ollama و DeepSeek و OpenRouter و أي واجهة برمجة تطبيقات متوافقة مع OpenAI. يُغلق الإطار الفجوة بين نماذج اللغة الكبيرة والأجهزة المحمولة الفعلية أو الافتراضية، مما يسمح للمستخدمين بوصف المهام باللغة الإنجليزية العادية وتنفيذها على الهاتف. يُسمى وقت التشغيل الأساسي Portal، والذي يتم تثبيته على الجهاز المستهدف. إنه يُظهر شجرة واجهة المستخدم، ولقطات الشاشة، ومدخلات النص، والإشارات، وتنفيذ التطبيقات، وحالة الجهاز للوكيل. يمكن للوكيل العمل في وضعين: وضع مباشر للمهام البسيطة، ووضع استدلال (مفعّل مع --reasoning) الذي يستخدم هيكلاً إدارياً لتنفيذ مهام متعددة الخطوات. يرسل وضع الرؤية ( --vision أو --vision-only) لقطات الشاشة إلى نموذج اللغة الكبيرة لفهم الرؤية، وهو مفيد بشكل خاص للتطبيقات التي تفتقر إلى معلومات شجرة الوصول. يمكن للمستخدمين التفاعل مع Mobilerun من خلال واجهات متعددة: أداة سطر الأوامر (CLI) للمهام الفردية، وفحص الجهاز، وإعادة تشغيل الماكرو، وتصحيح الأخطاء؛ وواجهة برمجة تطبيقات Python لبناء تدفقات عمل التutomatisation المخصصة وتكامل الأدوات المخصصة؛ وعنوان Docker للبيئات المتكررة المحتوية. يتضمن إعداد CLI السريع تثبيت عبر uv، و تشغيل mobilerun setup لتثبيت تطبيق Portal على الجهاز، وتكوين موفر نموذج اللغة الكبيرة مع mobilerun configure، ثم تنفيذ أوامر مثل mobilerun run "افتح الإعدادات و قم بتشغيل الوضع الداكن". يدعم الإطار الإخراج المنظم لإرجاع البيانات القابلة للقراءة آليًا من تدفقات العمل المحمولة، والأدوات المخصصة لتوسيع قدرات الوكيل، وبطاقات التطبيقات التي توفر إرشادات محددة للتطبيقات لتحسين أداء الوكيل في حالات استخدام محددة. يتم تضمين التتبع والتелеметري، مع دعم Arize Phoenix و Langfuse و المسارات المحفوظة و السجلات المفصلة لتصحيح أخطاء تنفيذ الوكيل. كما يقدم Mobilerun خدمة سحابية (Mobilerun Cloud) توفر بنية تحتية مُدارة، وأجهزة حقيقية أو افتراضية مضيفة، وواجهات برمجة تطبيقات REST، و SDK، و تدفقات عمل مدفوعة باللوحة. تشمل أنواع الأجهزة السحابية أجهزة شخصية متصلة بالسحابة، وأجهزة هاتف مضيفة سحابية للautomatisation القابلة للتحجيم، وأجهزة هاتف مضيفة مادية لتدفقات العمل التي تتطلب مصداقية جهاز عالية. تشمل حالات استخدام السحابة التutomatisation من WhatsApp على هاتف سحابي و إنشاء رصيد من Google Maps. تشمل الحالات التقليدية للاستخدام اختبار جودة التطبيق المحمول و اختبار الانحدار، و تدفقات العمل الموجهة للمستخدمين غير التقنيين، و تutomatisation المهام المتكررة، و التutomatisation الموجهة بالحدث من الجداول أو الإشعارات، و استخراج البيانات من التطبيقات المحمولة الأصلية، و تشغيل التutomatisations عبر عدة أجهزة في نفس الوقت. كما يوفر المشروع مهارة mobile-harness يمكن دمجها في وكلاء الترميز مثل Claude Code أو Codex لإعطائهم التحكم المباشر في الأجهزة المحمولة. المشروع مرخص تحت رخصة MIT و يرحب بالمساهمات. يمكن تشغيل فحوصات الأمان مع bandit و safety scan. يتم دعم Python 3.11 إلى 3.13؛ Python 3.14 غير مدعوم حاليًا.