قد تبدو فكرة امتلاك مساحة عمل ذكاء اصطناعي خاصة أمراً قوياً، إلى أن تبدأ شاشة التثبيت بطلب Python وGit وDocker والنماذج المحلية والمنافذ وأوامر الطرفية. هنا يتوقف الكثير من المبتدئين.

الخبر الجيد هو أن تثبيت Odysseus AI محلياً لا يجب أن يكون معقداً. من خلال مسار إعداد واضح، يمكنك تشغيل مساحة عمل ذكاء اصطناعي ذاتية الاستضافة على جهازك، وربط النماذج المحلية عبر Ollama، واختبار بوابة الويب على المنفذ 7000، والحفاظ على بياناتك تحت سيطرتك.

اكتسب Odysseus اهتماماً كبيراً لأنه يقدم تجربة ذكاء اصطناعي تعتمد على التشغيل المحلي أولاً: المحادثة، الوكلاء، أدوات البحث، تشغيل النماذج، الذاكرة، سير عمل الملفات، والتكاملات الاختيارية ضمن مساحة عمل واحدة تعمل من المتصفح. وبدلاً من الاعتماد الكامل على منصات الذكاء الاصطناعي السحابية، يمكن للمستخدمين بناء بيئة مساعد ذكاء اصطناعي خاصة تعمل على أجهزتهم الخاصة.

يرشدك هذا الدليل خلال عملية الإعداد الكاملة لمستخدمي Windows وmacOS وLinux، بما في ذلك فحص العتاد، خيار Docker، خيار التثبيت اليدوي، ربط Ollama، إعدادات الأمان، استكشاف الأخطاء، والتحقق النهائي.

إجابة سريعة: ما هو Odysseus AI؟

Odysseus AI هو مساحة عمل ذكاء اصطناعي ذاتية الاستضافة تتيح للمستخدمين التفاعل مع نماذج اللغة من خلال واجهة محلية. يمكنه دعم المحادثة، والوكلاء، وتشغيل النماذج، والبحث العميق، وسير عمل الملفات، واستخدام الأدوات المحلية. يصف موقع Odysseus AI الرسمي الأداة بأنها مساحة عمل تعتمد على التشغيل المحلي والخصوصية أولاً، وتعمل على العتاد الخاص بالمستخدم.

بعبارة بسيطة، هو ليس مجرد روبوت محادثة آخر. بل هو أقرب إلى طبقة تحكم لتشغيل سير عمل الذكاء الاصطناعي من جهازك. يمكنك ربط النماذج المحلية، واستخدام واجهات API خارجية إذا اخترت ذلك، وإدارة الملفات، واختبار الوكلاء، وإبقاء العمل الحساس بعيداً عن التعرض غير الضروري لأطراف خارجية.

بالنسبة للمبدعين التقنيين، والمطورين المستقلين، ومسؤولي خصوصية البيانات، فهذا مهم لأن الذكاء الاصطناعي المحلي يمنح سيطرة أكبر على البيانات، واختيار النماذج، وتصميم بيئة التشغيل.

لماذا أصبح الذكاء الاصطناعي المحلي مهماً؟

أدوات الذكاء الاصطناعي السحابية مريحة، لكنها ليست دائماً الخيار الأنسب لكل سير عمل. فالمطور الذي يختبر كوداً خاصاً، أو مسؤول الامتثال الذي يراجع مستندات داخلية، أو مستخدم الأعمال الذي يتعامل مع ملفات سرية، قد لا يرغب في توجيه كل مطالبة أو مرفق أو سير عمل عبر منصة خارجية.

لهذا السبب تنمو فكرة مساحة عمل ذكاء اصطناعي ذاتية الاستضافة بسرعة. يمكن للذكاء الاصطناعي المحلي أن يساعد المستخدمين على تقليل الاعتماد على السحابة، واختبار النماذج مفتوحة المصدر، والتحكم في أماكن التخزين، وبناء سير عمل خاص للبحث والأتمتة والتعامل مع المستندات.

يناسب Odysseus هذا التوجه لأنه يجمع عدة وظائف للذكاء الاصطناعي في واجهة واحدة. وبدلاً من استخدام أدوات منفصلة للمحادثة، والنماذج المحلية، والوكلاء، والبحث، والملفات، يمكن للمستخدم بدء بناء مساحة عمل مترابطة من مشروع واحد.

قبل تثبيت مثل هذه الأدوات، من المفيد أيضاً فهم أساسيات الذكاء الاصطناعي: النماذج، والمطالبات، والأتمتة، والسلامة، والاستخدام المسؤول. تعد دورة أساسيات الذكاء الاصطناعي مفيدة للمبتدئين الذين يريدون أساساً أقوى قبل العمل مع أدوات ذكاء اصطناعي محلية مثل Odysseus.

فحص العتاد والبيئة قبل البدء

قبل بدء تثبيت Odysseus AI محلياً، تحقق من بيئة جهازك. يمكن للتطبيق الأساسي أن يعمل على عتاد متوسط، لكن تشغيل النماذج المحلية هو الجزء الأكثر استهلاكاً للموارد. فالنماذج الأكبر تحتاج إلى ذاكرة RAM أكبر، وأداء CPU أفضل، ومن الأفضل وجود بطاقة GPU مخصصة.

حمّل الاعتمادات فقط من مصادر موثوقة. استخدم موقع Python الرسمي لتنزيل Python، وصفحة تثبيت Git الرسمية لتنزيل Git، ووثائق Docker Compose الرسمية لإعداد الحاويات، وصفحة تنزيل Ollama الرسمية إذا كنت تخطط لتشغيل النماذج المحلية على Windows.

الخطوة 1: استنساخ مستودع PewDiePie AI Project من GitHub

المستودع الرسمي مستضاف تحت اسم حساب PewDiePie AI project GitHub وهو pewdiepie-archdaemon/odysseus. ابدأ بإنشاء مجلد نظيف لمشاريع الذكاء الاصطناعي الخاصة بك.

افتح PowerShell أو Terminal أو الطرفية التي تفضلها:

mkdir ai-projects

cd ai-projects

git clone https://github.com/pewdiepie-archdaemon/odysseus.git

cd odysseus

يقوم هذا بتنزيل ملفات Odysseus المصدرية إلى جهازك. استخدم دائماً مستودع Odysseus الرسمي على GitHub بدلاً من النسخ العشوائية أو ملفات ZIP غير المعروفة. يمكن لمساحة عمل ذكاء اصطناعي ذاتية الاستضافة الوصول إلى الملفات، والرموز السرية، والأدوات، والخدمات المحلية، لذلك فإن موثوقية المصدر مهمة جداً.

الخطوة 2: اختر Docker أو التثبيت اليدوي

هناك مساران رئيسيان للتثبيت.

يعد Docker الخيار الأنظف لكثير من المستخدمين لأنه يحافظ على الاعتمادات داخل حاويات. أما التثبيت اليدوي فهو أفضل إذا كنت تريد أداءً محلياً مباشراً، أو تحتاج إلى تحكم أكبر، أو تستخدم Apple Silicon حيث قد لا يصل Docker إلى تسريع GPU بالطريقة نفسها التي تصل بها الأدوات المحلية.

بالنسبة لمعظم المبتدئين، ابدأ بـ Docker. أما مستخدمو Windows الذين يبحثون عن “كيفية تثبيت Odysseus AI بدون Docker على Windows”، فيمكنهم استخدام مسار Windows اليدوي أدناه.

الخطوة 3: تثبيت Odysseus AI محلياً باستخدام Docker

من داخل مجلد odysseus، شغّل:

cp .env.example .env

docker compose up -d --build

على Windows PowerShell، إذا لم يعمل الأمر cp، استخدم:

copy .env.example .env

docker compose up -d --build

بعد انتهاء عملية البناء، افتح المتصفح وانتقل إلى:

http://localhost:7000

ينشئ الإعداد الأول حساب مسؤول ويطبع كلمة مرور مؤقتة في الطرفية أو سجلات Docker. إذا فاتتك، شغّل:

docker compose logs odysseus

ثم سجّل الدخول وغيّر كلمة المرور من الإعدادات.

يجب على مستخدمي Docker معرفة ثلاثة أوامر مفيدة:

docker compose ps

docker compose logs --tail=120 odysseus

docker compose down

استخدم docker compose ps للتحقق مما إذا كانت الحاويات تعمل، واستخدم السجلات لفحص الأخطاء، واستخدم docker compose down لإيقاف المجموعة.

الخطوة 4: تثبيت Windows اليدوي بدون Docker

بالنسبة لمستخدمي Windows الذين يفضلون الإعداد المحلي، افتح PowerShell داخل مجلد المشاريع وشغّل:

git clone https://github.com/pewdiepie-archdaemon/odysseus.git

cd odysseus

py -3.11 -m venv venv

venv\Scripts\Activate.ps1

pip install -r requirements.txt

python setup.py

python -m uvicorn app:app --host 127.0.0.1 --port 7000

إذا منع PowerShell تفعيل السكربتات، شغّل:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

ثم فعّل البيئة الافتراضية مرة أخرى.

بعد التشغيل، افتح:

http://localhost:7000

هذا المسار مفيد عندما لا يكون Docker Desktop متاحاً، أو عندما تريد تثبيتاً مباشراً قائماً على Python.

الخطوة 5: التثبيت المحلي على Linux أو macOS

بالنسبة إلى Linux وmacOS، استخدم:

git clone https://github.com/pewdiepie-archdaemon/odysseus.git

cd odysseus

python3 -m venv venv

source venv/bin/activate

pip install -r requirements.txt

python setup.py

python -m uvicorn app:app --host 127.0.0.1 --port 7000

يجب على مستخدمي Linux تثبيت tmux أيضاً إذا أرادوا تنزيلات نماذج في الخلفية وسير عمل Cookbook أكثر سلاسة:

sudo apt update

sudo apt install tmux

على macOS، قد يفضل مستخدمو Apple Silicon المسار المحلي بدلاً من Docker عندما يكون أداء GPU المحلي مهماً. إذا كان المنفذ 7000 مشغولاً بالفعل، غيّر المنفذ إلى 7001 أو اتبع التعليمات الخاصة بـ macOS في المشروع.

الخطوة 6: ربط نماذج Ollama المحلية مع Odysseus

يعد Ollama من أسهل الطرق لتشغيل النماذج المحلية على Windows وmacOS وLinux. ثبّت Ollama أولاً، ثم اختبره:

ollama --version

ollama run gemma3

بعد تشغيل Ollama، افتح Odysseus وانتقل إلى Settings. أضف نقطة نهاية Ollama الخاصة بك.

بالنسبة لتثبيت Odysseus المحلي، تكون نقطة النهاية المعتادة:

http://localhost:11434/v1

أما بالنسبة لتثبيت Odysseus عبر Docker مع ربط Ollama على الجهاز المضيف، فاستخدم:

http://host.docker.internal:11434/v1

هذا مهم لأن الحاوية داخل Docker ترى الجهاز المضيف بطريقة مختلفة. يسمح عنوان host.docker.internal لـ Odysseus داخل Docker بالتواصل مع Ollama الذي يعمل خارج Docker.

وهذا يحل إحدى أكثر مشكلات نية البحث شيوعاً: ربط نماذج Ollama المحلية بمساحة عمل Odysseus.

الخطوة 7: استخدام ميزة Cookbook لترشيح النماذج

تعد ميزة Cookbook من أكثر أجزاء Odysseus فائدة للمبتدئين. فبدلاً من تخمين النموذج الذي يستطيع جهازك تشغيله، يمكن أن تساعدك Cookbook في ترشيح نماذج بناءً على عتاد جهازك.

هذا مهم لأن أداء الذكاء الاصطناعي المحلي يعتمد بدرجة كبيرة على RAM وVRAM وCPU وحجم النموذج. قد يعمل نموذج 7B بشكل مقبول على كثير من الأجهزة متوسطة المواصفات، بينما قد تتطلب النماذج الأكبر ذاكرة أكبر بكثير وقوة GPU أعلى.

استخدم Cookbook كنقطة بداية أكثر أماناً. ابدأ بالنماذج الأصغر، واختبر سرعة الاستجابة، وراقب حرارة الجهاز واستخدام الذاكرة، ثم انتقل إلى النماذج الأكبر فقط عندما يبقى جهازك مستقراً.

الأمان أولاً: لا تجعل Odysseus متاحاً للعامة

Odysseus قوي لأنه يمكنه الاتصال بالملفات، والأدوات، وخوادم النماذج، وإجراءات shell، وسير عمل البحث، والبريد الإلكتروني، والتقويم، ومفاتيح API. وهذا يعني أيضاً أنه يجب التعامل معه كلوحة تحكم إدارية.

احتفظ بإعداد localhost الافتراضي ما لم تكن تفهم أمان الشبكات. لا تعرض المنفذ 7000 مباشرة على الإنترنت العام. لا تعطل المصادقة في عمليات النشر المشتركة أو الشبكية. إذا كنت تحتاج إلى وصول عن بُعد، فاستخدم طبقة وصول خاصة، أو VPN، أو reverse proxy موثوقاً، وHTTPS، ومصادقة صارمة.

الإعدادات الآمنة الافتراضية:

إعداد مساعد ذكاء اصطناعي خاص على العتاد الشخصي يظل خاصاً فقط إذا تم تكوينه بعناية.

أخطاء التثبيت الشائعة وحلولها

لا تقلق إذا فشل التشغيل الأول. معظم الأخطاء تكون مرتبطة بالبيئة، وليست مشكلة في Odysseus نفسه.

قائمة التحقق النهائية

قبل استخدام Odysseus في عمل حقيقي، نفّذ هذه القائمة.

أرسل رسالة بسيطة مثل:

Hello. Confirm that you are connected and tell me which model is responding.

إذا رد النموذج، فهذا يعني أن تثبيت Odysseus AI المحلي يعمل بنجاح.

ماذا تفعل بعد التثبيت؟

بعد تشغيل مساحة العمل، ابدأ بخطوات صغيرة. اختبر المحادثة أولاً، ثم اربط النماذج، ثم جرّب الملفات، والذاكرة، والوكلاء، وسير عمل البحث. تجنب منح الوكلاء المستقلين وصولاً إلى ملفات حساسة إلى أن تفهم الأدوات المفعلة وكيف يتم تسجيل المخرجات.

بالنسبة للمستخدمين المهنيين في السعودية والمنطقة، يمكن للذكاء الاصطناعي المحلي دعم التجارب الخاصة، وسير عمل الإنتاجية الداخلية، واختبار الذكاء الاصطناعي بشكل آمن، وتبني الذكاء الاصطناعي بمسؤولية. لكن التثبيت ليس سوى الخطوة الأولى. إن معرفة كيفية استخدام الذكاء الاصطناعي بأمان، وكتابة مطالبات أفضل، ومقارنة النماذج، وإدارة مخاطر الذكاء الاصطناعي، هي ما يحول مساحة العمل المحلية إلى أداة أعمال مفيدة.

لهذا السبب تعد دورة  أساسيات الذكاء الاصطناعي خطوة تالية قوية للمتعلمين الذين يريدون فهم مفاهيم الذكاء الاصطناعي قبل بناء سير عمل أعمق باستخدام أدوات مثل Odysseus.

الخلاصة

يمثل Odysseus AI تحولاً أكبر في طريقة تفكير الناس بأدوات الذكاء الاصطناعي. فبدلاً من الاعتماد فقط على المنصات السحابية، يمكن للمستخدمين الآن بناء مساحة عمل ذكاء اصطناعي خاصة وذاتية الاستضافة على أجهزة الكمبيوتر الخاصة بهم.

يبدأ تثبيت Odysseus AI محلياً الناجح بالتحضير: تحقق من Python وGit وDocker وOllama وسعة العتاد والتخزين وإعدادات الشبكة. ثم اختر مسار النشر الأنسب: Docker لإعداد أنظف، أو تثبيت Windows اليدوي للتحكم المحلي المباشر، أو إعداد Linux/macOS المحلي للمستخدمين المتقدمين.

القاعدة الأهم هي الأمان. أبقِ Odysseus محلياً افتراضياً، واحمِ المصادقة، وتجنب التعرض العام، واختبر أولاً باستخدام بيانات منخفضة المخاطر. بعد استقرار مساحة العمل، يمكنك استكشاف النماذج المحلية، وترشيحات Cookbook، والوكلاء، وسير عمل الملفات، وأتمتة البحث الخاصة بثقة أكبر.

الأسئلة الشائعة

ما هو Odysseus AI؟

Odysseus AI هو مساحة عمل ذكاء اصطناعي ذاتية الاستضافة يمكنها تشغيل المحادثة، والوكلاء، وتشغيل النماذج، وسير عمل البحث، والملفات، والأدوات المحلية من عتادك الخاص.

هل Odysseus AI مجاني؟

مشروع Odysseus مفتوح المصدر ومتاح من خلال مستودعه الرسمي على GitHub. ومع ذلك، قد يحتاج المستخدمون إلى عتاد مناسب أو مزودي API مدفوعين اختياريين حسب إعدادهم.

هل يمكن تثبيت Odysseus AI بدون Docker على Windows؟

نعم. يمكنك تثبيته يدوياً باستخدام Python وGit وبيئة افتراضية واعتمادات المشروع وsetup.py وأمر تشغيل uvicorn.

ما المنفذ الذي يستخدمه Odysseus؟

تستخدم بوابة الويب المحلية عادة المنفذ 7000. يمكنك غالباً فتحها عبر http://localhost:7000 بعد التشغيل.

هل يعمل Odysseus مع Ollama؟

نعم. يمكن ربط Ollama كمحرك نماذج محلي. تستخدم التثبيتات المحلية عادة http://localhost:11434/v1، بينما قد تستخدم تثبيتات Docker العنوان http://host.docker.internal:11434/v1.

هل من الآمن عرض Odysseus على الإنترنت؟

لا تعرضه مباشرة على الإنترنت العام. أبقه محلياً افتراضياً، واستخدم المصادقة، وHTTPS، والشبكات الخاصة، أو reverse proxy موثوقاً فقط عندما يكون الوصول عن بُعد ضرورياً فعلاً.