Reference OS v8 5 دقائق قراءة ٢٠ مايو ٢٠٢٦ informational: شرح أداة ترجمة كتب مفتوحة المصدر وطريقة تركيبها واستخدامها عملياً ترجمة الكتب بالذكاء الاصطناعي: دليل تركيب واستخدام TranslateBooksWithLLMs…
Translate full-length books and documents with Ollama, OpenAI (comptatible), Gemini, Mistral, Poe or OpenRouter. Preserves formatting. Resumes where you left off. No file size limits.
اختر القسم الذي تحتاجه الآن
الفكرة التي تمنع التسرع
تعتقد أن ترجمة كتاب كامل بالذكاء الاصطناعي مكلفة ومعقدة وتحتاج أدوات احترافية؟ الحقيقة أن أداة مفتوحة المصدر واحدة تنجز المهمة مجاناً مع الحفاظ على التنسيق ودون حدود حجم.
قبل أن تطبق، اعرف أين تقف بالضبط
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
إذا كنت تبحث عن طريقة لترجمة كتاب تقني أو أكاديمي طويل دون فقدان التنسيق أو دفع مبالغ كبيرة، فأنت في المكان الصحيح. TranslateBooksWithLLMs أداة مفتوحة المصدر تترجم المستندات والكتب والترجمات النصية باستخدام نماذج لغوية كبيرة (LLMs)، مع ميزة الاستئناف من حيث توقفت. في هذا الدليل، ستتعلم كيفية تركيبها وتشغيلها خطوة بخطوة، مع أمثلة عملية تناسب السوق السعودي.
أداة سطر أوامر (CLI) مفتوحة المصدر مكتوبة بلغة Python، تتيح ترجمة الكتب والمستندات الطويلة باستخدام نماذج LLM مختلفة. تدعم صيغ DOCX و EPUB و SRT، وتحافظ على التنسيق الأصلي (عناوين، جداول، صور). يمكنك استخدامها مع نماذج سحابية (OpenAI, Gemini, Mistral, Poe, OpenRouter) أو محلية عبر Ollama. الميزة الأبرز: الاستئناف التلقائي في حال انقطاع الترجمة.
من يحتاجها: المطورون العرب، المترجمون التقنيون، طلاب الدراسات العليا، أصحاب المشاريع الصغيرة الذين يحتاجون ترجمة مستندات طويلة بتكلفة منخفضة. من لا يحتاجها: من يريد ترجمة فورية لنصوص قصيرة (استخدم Google Translate)، أو من لا يملك أي خبرة تقنية (تتطلب معرفة بسطر الأوامر).
افتح الطرفية (Terminal) ونفذ الأمر التالي:
docker run -p 5000:5000 -v $(pwd)/translated_files:/app/translated_files translatebookملاحظة: هذا الأمر تقريبي بناءً على README، قد تحتاج لبناء الصورة أولاً. راجع الوثائق الرسمية للتحديثات.
git clone https://github.com/hydropix/TranslateBooksWithLLMs.git
cd TranslateBooksWithLLMs
pip install -r requirements.txtانسخ ملف .env.example إلى .env وعدل القيم حسب الخدمة التي تختارها:
OPENROUTER_API_KEY=sk-or-v1-...
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...
MISTRAL_API_KEY=...
DEEPSEEK_API_KEY=...
POE_API_KEY=...
NIM_API_KEY=...ملاحظة: تحتاج مفتاحاً واحداً فقط. أنصح باستخدام Poe لأنه سهل الإعداد ويدعم نماذج متعددة.
بعد إعداد المفاتيح، استخدم الأمر التالي لترجمة ملف:
python translate.py --input book.docx --target-lang Arabic --model poe --api-key YOUR_POE_KEYإذا كنت تستخدم Docker، ستحتاج لتمرير المتغيرات عبر -e.
نعم، إذا كنت تترجم مستندات طويلة بانتظام وتريد حلاً مجانياً أو منخفض التكلفة مع الحفاظ على التنسيق. لكن إذا كنت تبحث عن ترجمة فورية أو لا تملك أي خبرة تقنية، فقد تكون الأدوات السحابية الجاهزة أفضل.
نعم، تدعم العربية كهدف، لكن جودة الترجمة تعتمد على النموذج المستخدم. نماذج Gemini وPoe جيدة للعربية.
Ollama مجاني تماماً لكن يتطلب موارد محلية (RAM 8GB+) وقد يكون أبطأ. Poe سحابي وسهل لكن له حدود استخدام مجانية.
لا، حسب README، الصيغ المدعومة هي DOCX و EPUB و SRT فقط. يمكنك تحويل PDF إلى DOCX باستخدام أدوات أخرى.
Gemini لديه طبقة مجانية (60 طلباً في الدقيقة)، لكن للكتب الطويلة قد تحتاج خطة مدفوعة. التكلفة تعتمد على حجم الكتاب.
الأداة تدعم الاستئناف التلقائي. شغّل الأمر نفسه مرة أخرى وستستأنف من حيث توقفت.
إذا كنت تستخدم Ollama محلياً، نعم. أما السحابي فأرسل البيانات لخوادم الطرف الثالث.
نظام تشغيل حديث، RAM 8GB على الأقل، مساحة تخزين للنموذج (4-8GB).
لا، الأداة مصممة للحواسيب. يمكنك استخدام Termux لكن غير موصى به.
خطوات عملية مرتبة من التشخيص إلى النتيجة
لماذا؟ أسهل وأسرع طريقة، لا تحتاج تثبيت Python يدوياً.
كيف؟ افتح Terminal ونفذ: docker run -p 5000:5000 -v $(pwd)/translated_files:/app/translated_files translatebook (قد تحتاج بناء الصورة أولاً).
الناتج: حاوية Docker تعمل على المنفذ 5000.
لماذا؟ الأداة تحتاج مفتاح API للتواصل مع نموذج LLM.
كيف؟ انسخ ملف .env.example إلى .env وعدل القيم: مثلاً POE_API_KEY=your_key. استخدم Poe للسهولة.
الناتج: ملف .env بمفتاح API صالح.
لماذا؟ لتجربة الأداة عملياً.
كيف؟ نفذ: python translate.py --input book.docx --target-lang Arabic --model poe --api-key YOUR_POE_KEY (أو عبر Docker مع -e).
الناتج: ملف مترجم بنفس التنسيق.
حوّل القراءة إلى تنفيذ سريع
docker run -p 5000:5000 -v $(pwd)/translated_files:/app/translated_files translatebook
python translate.py --input book.docx --target-lang Arabic --model poe --api-key YOUR_POE_KEY
اعرف أين يتعثر الناس وكيف تتجنب ذلك
ماذا تفعل حسب حالتك؟
إذا: إذا كنت مبتدئاً وتريد أسهل طريقة
إذن: استخدم التثبيت عبر Docker ومفتاح Poe API.
إذا: إذا كنت تريد حلاً مجانياً تماماً وتملك موارد محلية
إذن: استخدم Ollama محلياً (يتطلب 8GB RAM).
إذا: إذا كان مستندك حساساً وتريد الخصوصية
إذن: استخدم Ollama محلياً ولا تستخدم الخدمات السحابية.
جدول صغير يمنع التسويف
نقاط مختصرة ترجع لها لاحقاً
1. الأداة تدعم الاستئناف التلقائي بعد انقطاع الترجمة.
2. الصيغ المدعومة: DOCX, EPUB, SRT فقط.
3. يمكن استخدامها مع نماذج سحابية (OpenAI, Gemini, Mistral, Poe, OpenRouter) أو محلية (Ollama).
4. Poe API سهل الإعداد ويدعم نماذج متعددة.
5. Ollama مجاني تماماً لكن يتطلب 8GB RAM على الأقل.
6. لا تدعم PDF مباشرة، لكن يمكن تحويل PDF إلى DOCX.
7. الأداة مكتوبة بلغة Python وتعمل على Windows, macOS, Linux.
8. الترجمة إلى العربية مدعومة وجودتها تعتمد على النموذج.
9. التثبيت عبر Docker موصى به للمبتدئين.
إجابات مباشرة على ما يبحث عنه الزائر
تعريفات مختصرة تمنع الالتباس
نموذج لغوي كبير، مثل GPT-4 أو Gemini، يستخدم لفهم وتوليد النصوص.
واجهة سطر الأوامر، طريقة للتفاعل مع البرنامج عبر كتابة أوامر نصية.
مفتاح واجهة برمجة التطبيقات، رمز سري يسمح بالوصول إلى خدمة معينة.
أداة لتشغيل التطبيقات في حاويات معزولة، تسهل التثبيت والتشغيل.
أداة لتشغيل نماذج LLM محلياً على جهازك دون الحاجة لاتصال بالإنترنت.
منصة سحابية توفر واجهة API للوصول إلى نماذج LLM متعددة بسهولة.
استخدمها كمسارات متابعة داخل نفس الموضوع
تحول القارئ: من معتقد أن ترجمة كتاب كامل مكلفة ومعقدة إلى مستخدم قادر على ترجمة أي مستند مجاناً أو بتكلفة زهيدة مع الحفاظ على التنسيق.
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
TranslateBooksWithLLMs أداة قوية ومفتوحة المصدر تحل مشكلة حقيقية للمحتاجين لترجمة مستندات طويلة. باتباع هذا الدليل، يمكنك البدء في ترجمة كتبك الأولى اليوم. ابدأ بتجربة النموذج المجاني (Poe) ثم انتقل للمحلي إذا احتجت. شاركنا تجربتك في التعليقات.
حتى يبقى المرجع صالحاً مع الوقت
FAQ
استمر في القراءة
