عن المشروع

Pueo هو وكيل ذكاء اصطناعي مستقل يقوم بمراقبة مثيلات Home Assistant (HA) لتحديد المشكلات وإصلاحها دون الحاجة إلى تدخل مستمر من المستخدم. يعمل النظام بالكامل على الجهاز باستخدام Ollama للاستدلال المحلي، مما يضمن الخصوصية ويقلل الاعتماد على واجهات برمجة تطبيقات السحابة. تشمل القدرات الرئيسية ما يلي: - المراقبة اليقظة: يقوم ببث سجلات HA المباشرة عبر SSH وفرز الإدخالات باستخدام نموذج ذكاء اصطناعي محلي. - التشخيص التكيفي: يستخدم حلقة استدعاء أدوات تكرارية لتحليل ملفات التكوين، وإجراء فحوصات الحالة، وتحديد الأسباب الجذرية. - الإصلاح الذاتي: يقترح إصلاحات يتم اختبارها في بيئة معزولة (sandbox) وتطبيقها فقط بعد إنشاء لقطة نسخ احتياطي أصلية لـ HA. - قاعدة معرفية محلية RAG: يستخدم ChromaDB لتخزين والاستعلام عن ملاحظات إصدارات HA، وسجلات تغييرات HACS، ووثائق التكامل محلياً. - لوحة تحكم تفاعلية: يوفر واجهة ويب على المنفذ 8080 لمراجعة إجراءات الإصلاح، وعرض الجداول الزمنية للأحداث، والدردشة مع الوكيل للاستعلام عن حالة HA المباشرة أو تخزين ملاحظات دائمة. - تحليل التحديثات المخصص: يحلل تحديثات HA المتاحة مقابل تكوين المستخدم المحدد لتحديد التغييرات الجوهرية المؤثرة ذات الصلة. يمكن نشر النظام بشكل أصلي على macOS أو عبر Docker، ويدعم دورة تحقيق منظمة مكونة من 6 مراحل (استرجاع السياق، صياغة الفرضية، جمع الأدلة، تأكيد السبب الجذري، التنفيذ، وإعداد التقرير).