دليل إعداد كامل لـ Windows وmacOS وLinux — بما في ذلك استكشاف أخطاء الأكثر شيوعاً.
آخر تحديث: فبراير 2026
| Component | Minimum | Recommended |
|---|---|---|
| GPU | NVIDIA RTX 2080 (8GB VRAM) | NVIDIA RTX 3090/4090 (24GB VRAM) |
| CPU | Intel i7-8700 / AMD Ryzen 7 3700X | Intel i9-12900K / AMD Ryzen 9 5900X |
| RAM | 16GB DDR4 | 32GB+ DDR4 |
| Storage | 20GB SSD | 50GB+ NVMe SSD |
| CUDA Version | 11.8 | 12.1 |
| Python | 3.9 | 3.10 or 3.11 |
| OS | Windows 10, macOS 12, Ubuntu 20.04 | Ubuntu 22.04 LTS (best performance) |
نزّل Miniconda من conda.io وثبّته. يدير هذا بيئة Python ويمنع تعارضات التبعيات.
نفّذ: git clone https://github.com/ace-step/ACE-Step.git && cd ACE-Step
git clone https://github.com/ace-step/ACE-Step.git
cd ACE-Stepنفّذ: conda env create -f environment.yml && conda activate ace-step
conda env create -f environment.yml
conda activate ace-stepلـ CUDA 11.8: pip install torch==2.0.1+cu118 -f https://download.pytorch.org/whl/cu118/torch_stable.html
pip install torch==2.0.1+cu118 torchvision==0.15.2+cu118 torchaudio==2.0.2+cu118 \
-f https://download.pytorch.org/whl/cu118/torch_stable.htmlنفّذ: python download_models.py لجلب نقطة تفتيش النموذج (~15GB) من HuggingFace.
python download_models.pyنفّذ: python app.py لبدء واجهة الويب Gradio على http://localhost:7860
python app.pyللتوليد الأسرع، استخدم دقة FP16 (علامة --fp16) على وحدات معالجة الرسومات المدعومة. ثبّت xformers لتمكين xFormers attention وتحسين السرعة بنسبة 30-40%.
pip install xformers
python app.py --fp16إذا واجهت أخطاء CUDA OOM، حاول تمكين الكميّة 8 بت بإضافة --quantize int8 إلى أمر الإطلاق. أو قم بتمكين إلغاء تحميل المعالج المركزي بـ --cpu-offload.
python app.py --quantize int8
# or
python app.py --cpu-offload --fp16يتطلب ACE-Step إصدارات محددة من PyTorch وCUDA. استخدم دائماً ملف بيئة conda المقدم أو requirements.txt.
إذا كان المنفذ 7860 مشغولاً، أضف --port 7861 (أو أي منفذ متاح) إلى أمر تشغيل Gradio.
python app.py --port 7861تأكد من وجود مساحة كافية على القرص (~15GB لأوزان النموذج). شغّل سكريبت التنزيل من الدليل الجذري للمشروع.
لا تحب أوامر الطرفية وجحيم التبعيات؟ يوفر FM9 توليد موسيقى ذكاء اصطناعي متوافق مع ACE-Step في متصفحك. بدون وحدة معالجة رسومات، بدون إعداد، بدون انتظار.
ابدأ الإنشاء مجاناً