⛵ Odysseus AI
Your own AI workspace,
running on your hardware.
Complete installation guide for Windows 11 · Docker · Ollama — local-first, privacy-first, no telemetry.
Windows 11
Docker Desktop
Ollama
Arabic-Ready
100% Free Option
1
Install Prerequisites
Two tools needed before you start
1
Docker Desktop
Download from docker.com/products/docker-desktop. Enable the WSL2 backend when prompted, restart your PC, then wait for "Engine running".
⚠Allocate at least 8 GB RAM to WSL2. Create
C:\Users\YourName\.wslconfig and add:[wsl2]
memory=8GB2
Git
Download from git-scm.com with default settings. Verify:
git --version
2
Install Odysseus AI
6 steps · ~15 minutes first time
⚠Do NOT run from
C:\Windows\system32\ — navigate to a safe folder first.1
Open PowerShell & go to a safe folder
cd C:\
mkdir odysseus-app
cd odysseus-app
2
Clone the repository
git clone https://github.com/pewdiepie-archdaemon/odysseus.git .
3
Copy the environment file
cp .env.example .env
4
Build and start Odysseus
Takes 5–15 min on first run.
docker compose up -d --build
5
Open Odysseus in your browser
If port 7000 is taken, edit
.env → change APP_PORT=7001 → rerun compose.http://localhost:7000
6
Get your login credentials
Username: admin · Change password immediately after login via Settings → Account.
docker compose logs odysseus | Select-String "password"
3
Install Ollama (Free Local AI)
Run AI models on your PC — no internet, no API key, no cost
1
Install Ollama via PowerShell
irm https://ollama.com/install.ps1 | iex
2
Choose a model — click to see its pull command
qwen2.5
~4 GB RAM
✅ ArabicBalanced
ollama pull qwen2.5
qwen2.5:3b
~2 GB RAM
✅ ArabicFast
ollama pull qwen2.5:3b
llama3.2
~2 GB RAM
FastGeneral
ollama pull llama3.2
mistral
~4 GB RAM
SmartFast
ollama pull mistral
deepseek-r1
~4 GB RAM
Reasoning
ollama pull deepseek-r1
gemma3:1b
~1 GB RAM
Fastest
ollama pull gemma3:1b
3
Verify Ollama is running
ollama list
4
Connect a Model to Odysseus
Local or cloud — your choice
Connecting Ollama (Local)
Open Odysseus → Settings → Add Models → select LOCAL → paste URL below → leave API key empty → Test → Add.
http://host.docker.internal:11434/v1
All Supported Providers
⚙ Ollama (Local)
Free
⚡ Groq
Free tier
🌐 OpenRouter
Free models
🤖 OpenAI
Paid
✦ Anthropic
Paid
💎 Google Gemini
Free tier
💡Recommended: Ollama locally (free) + Groq as cloud backup (free tier at console.groq.com)
5
Tips & Troubleshooting
Speed tips and common fixes
Speed Tips
- Use smaller models (3b instead of 7b) for faster responses
- Close unused browser tabs and apps while chatting
- NVIDIA GPU? Ollama uses it automatically — check with
nvidia-smi - Keep conversations short — longer context = slower responses
Common Issues
Edit
.env → change APP_PORT=7001 → run:docker compose down && docker compose up -d
Use
host.docker.internal — not localhost. Inside Docker, localhost points to the container, not your PC.You cloned into the system32 folder. Delete it and re-clone into
C:\odysseus-app.docker compose logs odysseus | Select-String "password"
Quick Reference
| Action | Command |
|---|---|
| Start Odysseus | docker compose up -d |
| Stop Odysseus | docker compose down |
| View logs | docker compose logs odysseus |
| Restart after .env change | docker compose down && docker compose up -d |
| Pull a new model | ollama pull <modelname> |
| List Ollama models | ollama list |
| Check running containers | docker ps |
Official repo: github.com/pewdiepie-archdaemon/odysseus ·
Ollama: ollama.com
⛵ Odysseus AI
Your own AI workspace,
running on your hardware.
Complete installation guide for Windows 11 · Docker · Ollama — local-first, privacy-first, no telemetry.
Windows 11
Docker Desktop
Ollama
Arabic-Ready
100% Free Option
1
Install Prerequisites
Two tools needed before you start
1
Docker Desktop
Download from docker.com/products/docker-desktop. Enable the WSL2 backend when prompted, restart your PC, then wait for "Engine running".
⚠Allocate at least 8 GB RAM to WSL2. Create
C:\Users\YourName\.wslconfig and add:[wsl2]
memory=8GB2
Git
Download from git-scm.com with default settings. Verify:
git --version
2
Install Odysseus AI
6 steps · ~15 minutes first time
⚠Do NOT run from
C:\Windows\system32\ — navigate to a safe folder first.1
Open PowerShell & go to a safe folder
cd C:\
mkdir odysseus-app
cd odysseus-app
2
Clone the repository
git clone https://github.com/pewdiepie-archdaemon/odysseus.git .
3
Copy the environment file
cp .env.example .env
4
Build and start Odysseus
Takes 5–15 min on first run.
docker compose up -d --build
5
Open Odysseus in your browser
If port 7000 is taken, edit
.env → change APP_PORT=7001 → rerun compose.http://localhost:7000
6
Get your login credentials
Username: admin · Change password immediately after login via Settings → Account.
docker compose logs odysseus | Select-String "password"
3
Install Ollama (Free Local AI)
Run AI models on your PC — no internet, no API key, no cost
1
Install Ollama via PowerShell
irm https://ollama.com/install.ps1 | iex
2
Choose a model — click to see its pull command
qwen2.5
~4 GB RAM
✅ ArabicBalanced
ollama pull qwen2.5
qwen2.5:3b
~2 GB RAM
✅ ArabicFast
ollama pull qwen2.5:3b
llama3.2
~2 GB RAM
FastGeneral
ollama pull llama3.2
mistral
~4 GB RAM
SmartFast
ollama pull mistral
deepseek-r1
~4 GB RAM
Reasoning
ollama pull deepseek-r1
gemma3:1b
~1 GB RAM
Fastest
ollama pull gemma3:1b
3
Verify Ollama is running
ollama list
4
Connect a Model to Odysseus
Local or cloud — your choice
Connecting Ollama (Local)
Open Odysseus → Settings → Add Models → select LOCAL → paste URL below → leave API key empty → Test → Add.
http://host.docker.internal:11434/v1
All Supported Providers
⚙ Ollama (Local)
Free
⚡ Groq
Free tier
🌐 OpenRouter
Free models
🤖 OpenAI
Paid
✦ Anthropic
Paid
💎 Google Gemini
Free tier
💡Recommended: Ollama locally (free) + Groq as cloud backup (free tier at console.groq.com)
5
Tips & Troubleshooting
Speed tips and common fixes
Speed Tips
- Use smaller models (3b instead of 7b) for faster responses
- Close unused browser tabs and apps while chatting
- NVIDIA GPU? Ollama uses it automatically — check with
nvidia-smi - Keep conversations short — longer context = slower responses
Common Issues
Edit
.env → change APP_PORT=7001 → run:docker compose down && docker compose up -d
Use
host.docker.internal — not localhost. Inside Docker, localhost points to the container, not your PC.You cloned into the system32 folder. Delete it and re-clone into
C:\odysseus-app.docker compose logs odysseus | Select-String "password"
Quick Reference
| Action | Command |
|---|---|
| Start Odysseus | docker compose up -d |
| Stop Odysseus | docker compose down |
| View logs | docker compose logs odysseus |
| Restart after .env change | docker compose down && docker compose up -d |
| Pull a new model | ollama pull <modelname> |
| List Ollama models | ollama list |
| Check running containers | docker ps |
Official repo: github.com/pewdiepie-archdaemon/odysseus ·
Ollama: ollama.com
⛵ Odysseus AI
مساحة عمل الذكاء الاصطناعي الخاصة بك،
تعمل على جهازك.
دليل التثبيت الكامل لـ Windows 11 · Docker · Ollama — محلي أولاً، خصوصية أولاً، بدون تتبع.
Windows 11
Docker Desktop
Ollama
يدعم العربية
خيار مجاني 100%
١
تثبيت المتطلبات الأساسية
أداتان ضروريتان قبل البدء
١
Docker Desktop
حمّله من docker.com/products/docker-desktop. فعّل خلفية WSL2 عند المطالبة، أعد تشغيل الحاسوب، ثم انتظر ظهور "Engine running".
⚠خصص 8 جيجابايت على الأقل لـ WSL2. أنشئ ملفاً في المسار
C:\Users\YourName\.wslconfig وأضف:[wsl2]
memory=8GB٢
Git
حمّله من git-scm.com بالإعدادات الافتراضية. تحقق من التثبيت:
git --version
٢
تثبيت Odysseus AI
٦ خطوات · ما بين ٥ و١٥ دقيقة في المرة الأولى
⚠لا تُشغّل هذه الأوامر من
C:\Windows\system32\ — انتقل إلى مجلد آمن أولاً.١
افتح PowerShell وانتقل إلى مجلد آمن
cd C:\
mkdir odysseus-app
cd odysseus-app
٢
استنسخ المستودع الرسمي
git clone https://github.com/pewdiepie-archdaemon/odysseus.git .
٣
انسخ ملف البيئة
cp .env.example .env
٤
ابنِ Odysseus وشغّله
ستستغرق العملية ٥–١٥ دقيقة في المرة الأولى.
docker compose up -d --build
٥
افتح Odysseus في متصفحك
إذا كان المنفذ 7000 مستخدماً، عدّل
.env وغيّر APP_PORT=7001 ثم أعد تشغيل الأمر.http://localhost:7000
٦
احصل على بيانات تسجيل الدخول
اسم المستخدم: admin · غيّر كلمة المرور فوراً من الإعدادات ← الحساب.
docker compose logs odysseus | Select-String "password"
٣
تثبيت Ollama (ذكاء اصطناعي محلي مجاني)
شغّل نماذج الذكاء الاصطناعي على حاسوبك — بدون إنترنت، بدون API، بدون تكلفة
١
ثبّت Ollama عبر PowerShell
irm https://ollama.com/install.ps1 | iex
٢
اختر نموذجاً — انقر لعرض أمر التحميل
qwen2.5
~٤ جيجابايت RAM
✅ عربيمتوازن
ollama pull qwen2.5
qwen2.5:3b
~٢ جيجابايت RAM
✅ عربيسريع
ollama pull qwen2.5:3b
llama3.2
~٢ جيجابايت RAM
سريععام
ollama pull llama3.2
mistral
~٤ جيجابايت RAM
ذكيسريع
ollama pull mistral
deepseek-r1
~٤ جيجابايت RAM
تحليل
ollama pull deepseek-r1
gemma3:1b
~١ جيجابايت RAM
الأسرع
ollama pull gemma3:1b
٣
تحقق من تشغيل Ollama
ollama list
٤
ربط نموذج بـ Odysseus
محلي أو سحابي — الاختيار لك
ربط Ollama (محلي)
افتح Odysseus ← الإعدادات ← إضافة نماذج ← اختر LOCAL ← الصق الرابط ← اترك حقل API فارغاً ← Test ← Add.
http://host.docker.internal:11434/v1
جميع مزودي النماذج المدعومين
مجاني
http://host.docker.internal:11434/v1
⚙ Ollama (محلي)
مجاني
https://api.groq.com/openai/v1
⚡ Groq
مجاني جزئياً
https://openrouter.ai/api/v1
🌐 OpenRouter
مدفوع
https://api.openai.com/v1
🤖 OpenAI
مدفوع
https://api.anthropic.com/v1
✦ Anthropic
مجاني جزئياً
https://generativelanguage.googleapis.com/v1beta/openai
💎 Google Gemini
💡الموصى به: Ollama محلياً (مجاني) + Groq كاحتياطي سحابي سريع (خطة مجانية على console.groq.com)
٥
نصائح واستكشاف الأخطاء
نصائح لتحسين السرعة وحلول للمشكلات الشائعة
نصائح لتحسين السرعة
- استخدم نماذج أصغر (3b بدلاً من 7b) للحصول على استجابات أسرع
- أغلق علامات التبويب والتطبيقات غير المستخدمة أثناء المحادثة
- بطاقة NVIDIA؟ سيستخدمها Ollama تلقائياً — تحقق بـ
nvidia-smi - أبقِ المحادثات قصيرة — السياق الأطول = استجابات أبطأ
المشكلات الشائعة
عدّل
.env وغيّر APP_PORT=7001 ثم شغّل:docker compose down && docker compose up -d
استخدم
host.docker.internal وليس localhost في رابط نقطة النهاية. داخل Docker، يشير localhost إلى الحاوية وليس حاسوبك.استنسخت المستودع داخل مجلد system32. احذفه وأعد الاستنساخ في
C:\odysseus-app.docker compose logs odysseus | Select-String "password"
مرجع سريع — الأوامر الشائعة
| الإجراء | الأمر |
|---|---|
| تشغيل Odysseus | docker compose up -d |
| إيقاف Odysseus | docker compose down |
| عرض السجلات | docker compose logs odysseus |
| إعادة التشغيل بعد تعديل .env | docker compose down && docker compose up -d |
| تحميل نموذج Ollama جديد | ollama pull <modelname> |
| عرض نماذج Ollama | ollama list |
| التحقق من الحاويات الجارية | docker ps |
المستودع الرسمي: github.com/pewdiepie-archdaemon/odysseus ·
Ollama: ollama.com
⛵ Odysseus AI
مساحة عمل الذكاء الاصطناعي الخاصة بك،
تعمل على جهازك.
دليل التثبيت الكامل لـ Windows 11 · Docker · Ollama — محلي أولاً، خصوصية أولاً، بدون تتبع.
Windows 11
Docker Desktop
Ollama
يدعم العربية
خيار مجاني 100%
١
تثبيت المتطلبات الأساسية
أداتان ضروريتان قبل البدء
١
Docker Desktop
حمّله من docker.com/products/docker-desktop. فعّل خلفية WSL2 عند المطالبة، أعد تشغيل الحاسوب، ثم انتظر ظهور "Engine running".
⚠خصص 8 جيجابايت على الأقل لـ WSL2. أنشئ ملفاً في المسار
C:\Users\YourName\.wslconfig وأضف:[wsl2]
memory=8GB٢
Git
حمّله من git-scm.com بالإعدادات الافتراضية. تحقق من التثبيت:
git --version
٢
تثبيت Odysseus AI
٦ خطوات · ما بين ٥ و١٥ دقيقة في المرة الأولى
⚠لا تُشغّل هذه الأوامر من
C:\Windows\system32\ — انتقل إلى مجلد آمن أولاً.١
افتح PowerShell وانتقل إلى مجلد آمن
cd C:\
mkdir odysseus-app
cd odysseus-app
٢
استنسخ المستودع الرسمي
git clone https://github.com/pewdiepie-archdaemon/odysseus.git .
٣
انسخ ملف البيئة
cp .env.example .env
٤
ابنِ Odysseus وشغّله
ستستغرق العملية ٥–١٥ دقيقة في المرة الأولى.
docker compose up -d --build
٥
افتح Odysseus في متصفحك
إذا كان المنفذ 7000 مستخدماً، عدّل
.env وغيّر APP_PORT=7001 ثم أعد تشغيل الأمر.http://localhost:7000
٦
احصل على بيانات تسجيل الدخول
اسم المستخدم: admin · غيّر كلمة المرور فوراً من الإعدادات ← الحساب.
docker compose logs odysseus | Select-String "password"
٣
تثبيت Ollama (ذكاء اصطناعي محلي مجاني)
شغّل نماذج الذكاء الاصطناعي على حاسوبك — بدون إنترنت، بدون API، بدون تكلفة
١
ثبّت Ollama عبر PowerShell
irm https://ollama.com/install.ps1 | iex
٢
اختر نموذجاً — انقر لعرض أمر التحميل
qwen2.5
~٤ جيجابايت RAM
✅ عربيمتوازن
ollama pull qwen2.5
qwen2.5:3b
~٢ جيجابايت RAM
✅ عربيسريع
ollama pull qwen2.5:3b
llama3.2
~٢ جيجابايت RAM
سريععام
ollama pull llama3.2
mistral
~٤ جيجابايت RAM
ذكيسريع
ollama pull mistral
deepseek-r1
~٤ جيجابايت RAM
تحليل
ollama pull deepseek-r1
gemma3:1b
~١ جيجابايت RAM
الأسرع
ollama pull gemma3:1b
٣
تحقق من تشغيل Ollama
ollama list
٤
ربط نموذج بـ Odysseus
محلي أو سحابي — الاختيار لك
ربط Ollama (محلي)
افتح Odysseus ← الإعدادات ← إضافة نماذج ← اختر LOCAL ← الصق الرابط ← اترك حقل API فارغاً ← Test ← Add.
http://host.docker.internal:11434/v1
جميع مزودي النماذج المدعومين
مجاني
http://host.docker.internal:11434/v1
⚙ Ollama (محلي)
مجاني
https://api.groq.com/openai/v1
⚡ Groq
مجاني جزئياً
https://openrouter.ai/api/v1
🌐 OpenRouter
مدفوع
https://api.openai.com/v1
🤖 OpenAI
مدفوع
https://api.anthropic.com/v1
✦ Anthropic
مجاني جزئياً
https://generativelanguage.googleapis.com/v1beta/openai
💎 Google Gemini
💡الموصى به: Ollama محلياً (مجاني) + Groq كاحتياطي سحابي سريع (خطة مجانية على console.groq.com)
٥
نصائح واستكشاف الأخطاء
نصائح لتحسين السرعة وحلول للمشكلات الشائعة
نصائح لتحسين السرعة
- استخدم نماذج أصغر (3b بدلاً من 7b) للحصول على استجابات أسرع
- أغلق علامات التبويب والتطبيقات غير المستخدمة أثناء المحادثة
- بطاقة NVIDIA؟ سيستخدمها Ollama تلقائياً — تحقق بـ
nvidia-smi - أبقِ المحادثات قصيرة — السياق الأطول = استجابات أبطأ
المشكلات الشائعة
عدّل
.env وغيّر APP_PORT=7001 ثم شغّل:docker compose down && docker compose up -d
استخدم
host.docker.internal وليس localhost في رابط نقطة النهاية. داخل Docker، يشير localhost إلى الحاوية وليس حاسوبك.استنسخت المستودع داخل مجلد system32. احذفه وأعد الاستنساخ في
C:\odysseus-app.docker compose logs odysseus | Select-String "password"
مرجع سريع — الأوامر الشائعة
| الإجراء | الأمر |
|---|---|
| تشغيل Odysseus | docker compose up -d |
| إيقاف Odysseus | docker compose down |
| عرض السجلات | docker compose logs odysseus |
| إعادة التشغيل بعد تعديل .env | docker compose down && docker compose up -d |
| تحميل نموذج Ollama جديد | ollama pull <modelname> |
| عرض نماذج Ollama | ollama list |
| التحقق من الحاويات الجارية | docker ps |
المستودع الرسمي: github.com/pewdiepie-archdaemon/odysseus ·
Ollama: ollama.com