التواصل 📫

المساهم الرئيسي في هذا المستودع هو طالب ماجستير يتخرج في عام 2026، لا تتردد في التواصل من أجل التعاون أو الفرص.

المساهم الرئيسي في هذا المستودع هو طالب ماجستير يتخرج في عام 2026، مرحباً بالتواصل للتعاون أو فرص التبادل.

الأخبار 📅

• [2026/03]: أصبحنا الآن ندعم CLI وأصدرنا نماذجنا المعدلة على Hugging Face 🤗!
• [2026/01]: ندعم الآن التوليد الحر وقوالب PPTX مع إمكانية التصدير، ووضع العمل دون اتصال! تم إضافة إدارة السياق لتفادي تجاوز السياق.
• [2025/12]: 🔥 إصدار V2 مع تحسينات كبيرة - دمج البحث العميق، التصميم البصري الحر، إنشاء الأصول بشكل مستقل، توليد نص إلى صورة، وبيئة وكيل مع صندوق رمل وأكثر من 20 أداة.
• [2025/09]: 🛠️ تمت إضافة دعم خادم MCP - راجع خادم MCP لتفاصيل التكوين
• [2025/09]: 🚀 إصدار v2 مع تحسينات كبيرة - راجع ملاحظات الإصدار للتفاصيل
• [2025/08]: 🎉 تم قبول الورقة في EMNLP 2025!
• [2025/05]: ✨ إصدار v1 مع الوظائف الأساسية و 🌟 إنجاز: وصلنا إلى 1,000 نجمة على GitHub! - راجع ملاحظات الإصدار للتفاصيل
• [2025/01]: 🔓 تم فتح مصدر الكود، مع أرشفة الكود التجريبي في الإصدار التجريبي

الاستخدام 📖

[!هام]

لا يدعم ويندوز. إذا كنت على ويندوز، يرجى استخدام WSL.

نوصي بشدة بالبدء من CLI وأقل مهمة للتأكد من أن الاعتمادات والبيئة تم تكوينها بشكل صحيح.

التكوين

إذا استخدمت CLI، فإن pptagent onboard يمكنه مساعدتك في إنشاء وتحديث هذه الإعدادات بشكل تفاعلي. إذا استخدمت Docker Compose أو البناء من المصدر، عليك إعدادها يدوياً:

cp deeppresenter/config.yaml.example deeppresenter/config.yaml
cp deeppresenter/mcp.json.example deeppresenter/mcp.json

#### الخدمات الاختيارية التي تحسن الجودة

الخدمات التالية يمكن أن تحسن جودة التوليد بشكل ملحوظ، خاصة في تعميق البحث، واستخلاص PDF، وإنشاء الأصول البصرية:

• Tavily: يحسن جودة البحث على الويب. قدم طلبًا لمفتاح API في tavily.com، ثم عيّن TAVILY_API_KEY في deeppresenter/mcp.json.
• MinerU: يحسن جودة استخلاص PDF. يمكنك إما التقديم على مفتاح API في mineru.net وتعيين MINERU_API_KEY في deeppresenter/mcp.json، أو نشر MinerU محليًا وتعيين MINERU_API_URL بدلاً من ذلك.
• نموذج تحويل النص إلى صورة: يحسن جودة توليد الصور. قم بتهيئة t2i_model في deeppresenter/config.yaml.

يمكن العثور على المزيد من المتغيرات القابلة للتهيئة في constants.py.

1. الاستخدام الشخصي / تكامل OpenClaw: سطر الأوامر

[!ملاحظة]

في macOS، قد يقوم سطر الأوامر تلقائيًا بتثبيت العديد من التبعيات المحلية، بما في ذلك Homebrew وNode.js وDocker وpoppler وPlaywright وllama.cpp.

في Linux، يجب عليك تحضير البيئة بنفسك.

استخدم هذا الوضع إذا كنت تريد أسرع إعداد محلي أو ترغب في توصيل DeepPresenter بـ OpenClaw عبر سطر الأوامر.

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
First-time interactive setup
uvx pptagent onboard
Generate a presentation
uvx pptagent generate "Single Page with Title: Hello World" -o hello.pptx
Generate with attachments
uvx pptagent generate "Q4 Report" \
  -f data.xlsx \
  -f charts.pdf \
  -p "10-12" \
  -o report.pptx

| الأمر | الوصف | | ------------------- | ------------------------------------------------- | | pptagent onboard | معالج الإعداد التفاعلي | | pptagent generate | توليد العروض التقديمية | | pptagent config | عرض التهيئة الحالية | | pptagent reset | إعادة تعيين التهيئة | | pptagent serve | بدء خدمة الاستدلال المحلية المستخدمة بواسطة CLI |

٢. الإعداد الأدنى / التطوير: البناء من المصدر

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

uv pip install -e .
playwright install-deps
playwright install chromium
npm install --prefix deeppresenter/html2pptx
modelscope download forceless/fasttext-language-id
docker pull forceless/deeppresenter-sandbox
docker pull forceless/deeppresenter-host
docker tag forceless/deeppresenter-sandbox deeppresenter-sandbox
or build from dockerfile
docker build -t deeppresenter-sandbox -f deeppresenter/docker/SandBox.Dockerfile .

ابدأ التطبيق:

python webui.py

3. نشر الخادم: Docker Compose

استخدم هذا الوضع للحصول على بيئة خادم مستقرة مع الاعتماديات المحددة بشكل واضح.

# Pull the public images to avoid build from source
docker pull forceless/deeppresenter-sandbox
docker tag forceless/deeppresenter-sandbox deeppresenter-sandbox
Or build from source
docker build -t deeppresenter-sandbox -f deeppresenter/docker/SandBox.Dockerfile .
Start the host service
docker compose up -d

The service exposes the web UI on http://localhost:7861.

Case Study 💡

• #### Prompt: Please present the given document to me.

• #### Prompt: 请介绍小米 SU7 的外观和价格

• #### Prompt: 请制作一份高中课堂展示课件，主题为“解码立法过程：理解其对国际关系的影响”

المساهمون 🌟

Force1ess	Puelloc	hongyan	Dnoob	ساداهلو
كريسو ماكيسي سامي	أنجيلين	براندون هو	إليوت وايت	EvolvedGhost
ISCAS-zwl	James Brown	JunZhang	Open AI Tx	Sense_wang
سو ياو	زاكير جيوني	تشنيو	lnennnn

الاقتباس 🙏

إذا وجدت هذا المشروع مفيدًا، يرجى استخدام ما يلي للاقتباس منه:

@inproceedings{zheng-etal-2025-pptagent,
    title = "{PPTA}gent: Generating and Evaluating Presentations Beyond Text-to-Slides",
    author = "Zheng, Hao  and
      Guan, Xinyan  and
      Kong, Hao  and
      Zhang, Wenkai  and
      Zheng, Jia  and
      Zhou, Weixiang  and
      Lin, Hongyu  and
      Lu, Yaojie  and
      Han, Xianpei  and
      Sun, Le",
    editor = "Christodoulopoulos, Christos  and
      Chakraborty, Tanmoy  and
      Rose, Carolyn  and
      Peng, Violet",
    booktitle = "Proceedings of the 2025 Conference on Empirical Methods in Natural Language Processing",
    month = nov,
    year = "2025",
    address = "Suzhou, China",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2025.emnlp-main.728/",
    doi = "10.18653/v1/2025.emnlp-main.728",
    pages = "14413--14429",
    ISBN = "979-8-89176-332-6",
    abstract = "Automatically generating presentations from documents is a challenging task that requires accommodating content quality, visual appeal, and structural coherence. Existing methods primarily focus on improving and evaluating the content quality in isolation, overlooking visual appeal and structural coherence, which limits their practical applicability. To address these limitations, we propose PPTAgent, which comprehensively improves presentation generation through a two-stage, edit-based approach inspired by human workflows. PPTAgent first analyzes reference presentations to extract slide-level functional types and content schemas, then drafts an outline and iteratively generates editing actions based on selected reference slides to create new slides. To comprehensively evaluate the quality of generated presentations, we further introduce PPTEval, an evaluation framework that assesses presentations across three dimensions: Content, Design, and Coherence. Results demonstrate that PPTAgent significantly outperforms existing automatic presentation generation methods across all three dimensions."
}
@misc{zheng2026deeppresenterenvironmentgroundedreflectionagentic,
      title={DeepPresenter: Environment-Grounded Reflection for Agentic Presentation Generation},
      author={Hao Zheng and Guozhao Mo and Xinru Yan and Qianhao Yuan and Wenkai Zhang and Xuanang Chen and Yaojie Lu and Hongyu Lin and Xianpei Han and Le Sun},
      year={2026},
      eprint={2602.22839},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2602.22839},
}

--- Tranlated By Open Ai Tx | Last indexed: 2026-04-09 ---