عن المشروع

يوفر هذا المستودع مجموعة من أدوار Ansible لبناء بنية تحتية للذكاء الاصطناعي/LLM في المختبر المنزلي (homelab) على أجهزة Proxmox VMs وحاويات LXC. تم استخراج هذه الأدوار من مجموعة ansible-proxmox-apps أكبر وتركز بشكل خاص على مجموعة أدوات AI. تنقسم الأدوار إلى عدة مجالات وظيفية: - تقديم LLM: ollama (خادم النماذج)، وllama_cpp مع llama-swap (طبقة GPU)، وllm_router (وكيل LiteLLM كواجهة متوافقة مع OpenAI)، وopen_webui (واجهة دردشة أمامية). - RAG: llamaindex (خط أنابيب تضمينات Python + Ollama المعتمد على CPU فقط) وqdrant_docker (قاعدة بيانات متجهة). - الوكلاء: hermes_agent (بوابة وكيل NousResearch)، وagent_exec (تنفيذ معزول)، وagentgateway_docker، وcodex_runner (مستخدم Codex CLI معزول). - منصات تطبيقات LLM: Dify وLangFlow وLangGraph وLangfuse وArize Phoenix (جميعها تعتمد على Docker). - العمليات: fabric_watchdog، وهو مؤقت systemd يقوم بفحص نسيج الوكلاء من ضيف Hermes ويرسل تنبيهات عبر Slack. تتم إدارة أدوات التطوير عبر Nix flake وdirenv، مما يوفر ansible-core وansible-lint وmolecule وsops والأدوات ذات الصلة. تتوفر عمليات التدقيق (Linting) والاختبار القائم على molecule (باستخدام Docker) للأدوار الفردية. حالياً يتم شحن الأدوار فقط؛ ومن المخطط لاحقاً توفير playbook على مستوى الموقع ومحمل للمخزون (inventory loader). يستخدم المشروع الالتزامات التقليدية (conventional commits) ونموذج تفرع git-flow (فرع develop). مرخص بموجب Apache 2.0.