> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/almyzat-alreysyh/headless.md).

# الاستخدام بدون واجهة (Headless)

هذا القسم يشرح كيفية تشغيل AugeLab Studio بدون واجهة سطح المكتب عبر الفئة العامة `studio.StudioScenario`.

{% hint style="info" %}
واجهة برمجة التطبيقات Headless تمنح تحسينات أداء كبيرة مقارنة بواجهة سطح المكتب، خاصة عند التشغيل على خوادم بدون GPU. كما تتيح سهولة التكامل مع تطبيقات وخدمات Python الأخرى.
{% endhint %}

***

## تحويل التدفقات إلى كود

السيناريوهات التي بُرمجت بصريًا (ملفات `.pmod`) يمكن تشغيلها بدون واجهة عبر كود Python:

<figure><img src="/files/1RK2PUI9ew5UB1abHcEd" alt="Flows to Code" width="400"><figcaption><p>Flows to Code</p></figcaption></figure>

```python
from studio import StudioScenario
scenario = StudioScenario(verification_code="YOUR_CODE_HERE")
scenario.load_scenario("your_scenario.pmod")

while True:
    try:
        scenario.run()
    except KeyboardInterrupt:
        break
scenario.cleanup()
```

تشغيل ملفات `.pmod` المحفوظة عبر سكربتات Python يمنحك عدة فوائد:

* تنفيذ لوحات معلومات وواجهات مستخدم خاصة بك
* دمج السيناريوهات داخل تطبيقات أكبر
* الارتباط بنظام التسجيل (logging) في وقت تشغيل AugeLab
* تشغيل السيناريوهات داخل حاويات Docker (CPU/CUDA)
* معالجة دفعات متعددة من المدخلات
* أتمتة التشغيل والجدولة

والمزيد!