README Ar

ما عليك سوى تقديم <b>موضوع</b> أو <b>كلمة مفتاحية</b> للفيديو، وسيقوم التطبيق تلقائياً بتوليد نص الفيديو، ومواد الفيديو، والترجمة، وموسيقى الخلفية، ثم تركيبها في فيديو قصير عالي الدقة.

واجهة الويب (WebUI)

واجهة الـ API

المميزات 🎯

• بنية MVC كاملة، وكود واضح التنظيم وسهل الصيانة، يدعم كلاً من API وواجهة الويب
• يدعم توليد نص الفيديو بالذكاء الاصطناعي، إضافةً إلى النص المخصّص
• يدعم أحجام فيديو عالي الدقة متنوعة
  • عمودي 9:16، 1080x1920
  • أفقي 16:9، 1920x1080
• يدعم توليد الفيديو دفعةً واحدة، فيمكن إنشاء عدة فيديوهات معاً ثم اختيار الأفضل
• يدعم ضبط مدة مقاطع الفيديو، مما يسهّل التحكم في تكرار تبديل المواد
• يدعم نص الفيديو بكل من الصينية والإنجليزية
• يدعم تركيب أصوات متعددة، مع معاينة فورية للنتيجة
• يدعم توليد الترجمة، مع إمكانية ضبط الخط والموضع واللون والحجم، كما يدعم تحديد إطار الترجمة
• يدعم موسيقى الخلفية، إما عشوائية أو ملفات موسيقى محدّدة، مع إمكانية ضبط مستوى صوت موسيقى الخلفية
• مصادر مواد الفيديو عالية الدقة وخالية من حقوق الملكية، كما يمكنك استخدام موادك المحلية الخاصة
• يدعم التكامل مع نماذج متعددة مثل OpenAI وMoonshot وAzure وgpt4free وone-api وQwen وGoogle Gemini وOllama وDeepSeek وMiniMax وERNIE وPollinations وModelScope وغيرها

عروض فيديو توضيحية 📺

عمودي 9:16

أفقي 16:9

متطلبات النظام 📦

• المنصّات المُوصى بها: Windows 10+ أو macOS 11+ أو توزيعة Linux رئيسية
• وجود كرت رسومات (GPU) ليس ضرورياً، لكنه مُستحسَن إن أردت نسخاً صوتياً محلياً أسرع، أو معالجة فيديو أسرع، أو توليداً دفعياً أكثر سلاسة

• إذا كنت تعتمد أساساً على نماذج LLM السحابية، وخدمات TTS السحابية، ومصادر المواد عبر الإنترنت، فإن المعالج والذاكرة أهم من كرت الرسومات
• إذا كنت تستخدم faster-whisper أو التوليد الدفعي أو المعالجة المحلية الثقيلة، فسيحسّن كرت الرسومات الإنتاجية بشكل ملحوظ

البدء السريع 🚀

المسارات المُوصى بها

• مستخدمو Windows: استخدم الحزمة الجاهزة بنقرة واحدة أولاً للتجربة المحلية الأسرع
• مستخدمو MacOS / Linux: استخدم uv sync --frozen كمسار الإعداد المحلي الأساسي
• إذا أردت بيئة تشغيل أكثر عزلاً: استخدم النشر عبر Docker

التشغيل في Google Colab

تريد تجربة MoneyPrinterTurbo دون إعداد بيئة محلية؟ شغّله مباشرةً في Google Colab!

Windows

الحزمة القابلة للتنزيل ما زالت بناء v1.2.6 القديم المُجمّع. بعد التنزيل، شغّل update.bat أولاً لتحديثه إلى أحدث كود.

Google Drive (v1.2.6): https://drive.google.com/file/d/1HsbzfT7XunkrCrHw5ncUjFX8XX4zAuUh/view?usp=sharing

بعد التنزيل، يُنصح بالنقر المزدوج على update.bat أولاً للتحديث إلى أحدث كود، ثم النقر المزدوج على start.bat للتشغيل

بعد التشغيل، سيُفتح المتصفح تلقائياً (إن فُتح فارغاً، يُنصح باستخدام Chrome أو Edge)

الأنظمة الأخرى

لم تُنشأ حزم تشغيل بنقرة واحدة بعد. راجع قسم التثبيت والنشر أدناه. يُنصح باستخدام docker للنشر لأنه أكثر سهولة.

التثبيت والنشر 📥

المتطلبات المُسبقة

① استنساخ المشروع

git clone https://github.com/harry0703/MoneyPrinterTurbo.git

② تعديل ملف الإعدادات

• انسخ ملف config.example.toml وأعد تسميته إلى config.toml
• اتبع التعليمات داخل ملف config.toml لضبط pexels_api_keys وllm_provider، وبحسب مزوّد خدمة الـ llm_provider، اضبط مفتاح الـ API المقابل

النشر عبر Docker 🐳

① تشغيل حاوية Docker

إذا لم تكن قد ثبّت Docker، فثبّته أولاً https://www.docker.com/products/docker-desktop/ إذا كنت تستخدم نظام Windows، فراجع وثائق Microsoft:

1. https://learn.microsoft.com/en-us/windows/wsl/install
2. https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers

cd MoneyPrinterTurbo
docker-compose up

ملاحظة: أحدث إصدار من docker يثبّت docker compose تلقائياً على هيئة إضافة (plug-in)، ويتغيّر أمر التشغيل إلى docker compose up

② الوصول إلى واجهة الويب

افتح متصفحك وزر http://127.0.0.1:8501

③ الوصول إلى واجهة الـ API

افتح متصفحك وزر http://0.0.0.0:8080/docs أو http://0.0.0.0:8080/redoc

النشر اليدوي 📦

① إنشاء بيئة Python افتراضية

يُنصح باستخدام uv لإدارة بيئة Python والاعتماديات، مع Python 3.11 كبيئة تشغيل افتراضية.

git clone https://github.com/harry0703/MoneyPrinterTurbo.git
cd MoneyPrinterTurbo
uv python install 3.11
uv sync --frozen

إذا كنت لا تستخدم uv بعد، فما زال بإمكانك استخدام venv + pip.

python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

ملاحظات:

• أصبح pyproject.toml هو ملف الاعتماديات الأساسي.
• يُثبّت uv.lock البيئة المُحدّدة، لذا يُنصح بـ uv sync --frozen افتراضياً.
• يُحتفظ بـ requirements.txt فقط للتثبيت القديم المعتمد على pip.

② تثبيت ImageMagick

Windows:

• نزّل من https://imagemagick.org/script/download.php واختر نسخة Windows، وتأكد من اختيار نسخة المكتبة الساكنة (static library)، مثل ImageMagick-7.1.1-32-Q16-x64-static.exe
• ثبّت ImageMagick الذي نزّلته، ولا تغيّر مسار التثبيت
• عدّل ملف الإعدادات config.toml، واضبط imagemagick_path على مسار التثبيت الفعلي لديك

MacOS:

brew install imagemagick

Ubuntu

sudo apt-get install imagemagick

CentOS

sudo yum install ImageMagick

③ تشغيل واجهة الويب 🌐

لاحظ أنك بحاجة لتنفيذ الأوامر التالية في المجلد الجذر لمشروع MoneyPrinterTurbo

Windows

uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False

إذا كنت قد فعّلت البيئة الافتراضية يدوياً، فما زال بإمكانك تشغيل:

webui.bat

MacOS أو Linux

uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False

إذا كنت قد فعّلت البيئة الافتراضية يدوياً، فما زال بإمكانك تشغيل:

sh webui.sh

بعد التشغيل، سيُفتح المتصفح تلقائياً

④ تشغيل خدمة الـ API 🚀

uv run python main.py

إذا كنت قد فعّلت البيئة الافتراضية يدوياً، فما زال بإمكانك تشغيل:

python main.py

شكر خاص 🙏

نظراً لأن نشر واستخدام هذا المشروع يمثّل عتبةً معينة لبعض المستخدمين المبتدئين، نودّ أن نتقدّم بشكر خاص إلى

RecCloud (منصة خدمات وسائط متعددة مدعومة بالذكاء الاصطناعي) لتقديمها خدمة AI Video Generator مجانية مبنية على هذا المشروع. فهي تتيح الاستخدام عبر الإنترنت دون نشر، وهو أمر مريح للغاية.

• النسخة الصينية: https://reccloud.cn
• النسخة الإنجليزية: https://reccloud.com

شكراً للرعاية 🙏

شكراً لـ Picwish https://picwish.com على دعمها ورعايتها لهذا المشروع، مما يتيح التحديث والصيانة المستمرّين.

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

بعد التشغيل، يمكنك عرض وثائق الـ API على http://127.0.0.1:8080/docs واختبار الواجهة مباشرةً عبر الإنترنت لتجربة سريعة.

تركيب الصوت 🗣

يمكن عرض قائمة بجميع الأصوات المدعومة هنا: قائمة الأصوات

2024-04-16 v1.1.2 أُضيفت 9 أصوات تركيب صوتي جديدة من Azure تتطلب ضبط مفتاح API. هذه الأصوات تبدو أكثر واقعية.

توليد الترجمة 📜

حالياً، هناك طريقتان لتوليد الترجمة:

• edge: سرعة توليد أعلى، وأداء أفضل، ولا متطلبات خاصة لمواصفات الحاسوب، لكن الجودة قد تكون غير مستقرة
• whisper: سرعة توليد أبطأ، وأداء أضعف، ومتطلبات خاصة لمواصفات الحاسوب، لكن الجودة أكثر موثوقية

يمكنك التبديل بينهما بتعديل subtitle_provider في ملف الإعدادات config.toml

يُنصح باستخدام وضع edge، والتبديل إلى وضع whisper إذا كانت جودة الترجمة المُولّدة غير مُرضية.

ملاحظة:

1. في وضع whisper، تحتاج إلى تنزيل ملف نموذج من HuggingFace بحجم نحو 3GB، فتأكد من اتصال إنترنت جيد
2. إذا تُرك فارغاً، فهذا يعني أنه لن تُولَّد أي ترجمة.

بما أن HuggingFace غير متاح في الصين، يمكنك استخدام الطرق التالية لتنزيل ملف نموذج whisper-large-v3

روابط التنزيل:

• Baidu Netdisk: https://pan.baidu.com/s/11h3Q6tsDtjQKTjUu3sc5cA?pwd=xjs9
• Quark Netdisk: https://pan.quark.cn/s/3ee3d991d64b

بعد تنزيل النموذج، فُكّ ضغطه وضع المجلد بالكامل في .\MoneyPrinterTurbo\models، وينبغي أن يبدو مسار الملف النهائي هكذا: .\MoneyPrinterTurbo\models\whisper-large-v3

MoneyPrinterTurbo
  ├─models
  │   └─whisper-large-v3
  │          config.json
  │          model.bin
  │          preprocessor_config.json
  │          tokenizer.json
  │          vocabulary.json

موسيقى الخلفية 🎵

تقع موسيقى خلفية الفيديوهات في مجلد المشروع resource/songs.

يتضمّن المشروع الحالي بعض الموسيقى الافتراضية من فيديوهات YouTube. إن وُجدت مشكلات حقوق نشر، فالرجاء حذفها.

خطوط الترجمة 🅰

تقع خطوط عرض ترجمة الفيديو في مجلد المشروع resource/fonts، ويمكنك أيضاً إضافة خطوطك الخاصة.

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

❓RuntimeError: No ffmpeg exe could be found

في الوضع الطبيعي، يُنزَّل ffmpeg ويُكتشَف تلقائياً. لكن إذا كانت بيئتك تعاني مشكلات تمنع التنزيل التلقائي، فقد تواجه الخطأ التالي:

RuntimeError: No ffmpeg exe could be found.
Install ffmpeg on your system, or set the IMAGEIO_FFMPEG_EXE environment variable.

في هذه الحالة، يمكنك تنزيل ffmpeg من https://www.gyan.dev/ffmpeg/builds/ ثم فك ضغطه وضبط ffmpeg_path على مسار التثبيت الفعلي لديك.

[app]
# الرجاء الضبط بحسب مسارك الفعلي، ولاحظ أن فاصل المسارات في Windows هو \\
ffmpeg_path = "C:\\Users\\harry\\Downloads\\ffmpeg.exe"

❓ImageMagick is not installed on your computer

issue 33

1. اتبع عنوان التنزيل الموجود في الإعداد النموذجي لتثبيت https://imagemagick.org/archive/binaries/ImageMagick-7.1.1-30-Q16-x64-static.exe (باستخدام المكتبة الساكنة)
2. لا تثبّت في مسار يحتوي على أحرف صينية لتجنّب مشكلات غير متوقّعة

issue 54

لأنظمة Linux، يمكنك تثبيته يدوياً، راجع https://cn.linux-console.net/?p=16978

شكراً لـ @wangwenqiao666 على بحثه واستكشافه

❓ImageMagick's security policy prevents operations related to temporary file @/tmp/tmpur5hyyto.txt

يمكنك إيجاد هذه السياسات في ملف إعدادات ImageMagick policy.xml. يقع هذا الملف عادةً في /etc/ImageMagick-X/ أو موقع مشابه في مجلد تثبيت ImageMagick. عدّل المُدخل الذي يحتوي على pattern="@"، وغيّر rights="none" إلى rights="read|write" للسماح بعمليات القراءة والكتابة على الملفات.

❓OSError: [Errno 24] Too many open files

تنتج هذه المشكلة عن حدّ النظام لعدد الملفات المفتوحة. يمكنك حلّها بتعديل حدّ فتح الملفات في النظام.

تحقّق من الحدّ الحالي:

ulimit -n

إن كان منخفضاً جداً، يمكنك زيادته، مثلاً:

ulimit -n 10240

❓Whisper model download failed, with the following error

LocalEntryNotfoundEror: Cannot find an appropriate cached snapshotfolderfor the specified revision on the local disk and outgoing trafic has been disabled. To enablerepo look-ups and downloads online, pass 'local files only=False' as input.

أو

An error occurred while synchronizing the model Systran/faster-whisper-large-v3 from the Hugging Face Hub: An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision on the local disk. Please check your internet connection and try again. Trying to load the model directly from the local cache, if it exists.

الحل: اضغط لمعرفة كيفية تنزيل النموذج يدوياً من قرص الشبكة

الملاحظات والاقتراحات 📢

• يمكنك إرسال issue أو pull request.

الرخصة 📝

اضغط لعرض ملف LICENSE

تاريخ النجوم (Star History)