# Pixelle-Video 🎬

<div align="center" markdown="1">

**AI Video Creator - Generate a short video in 3 minutes**

[![Stars](https://img.shields.io/github/stars/AIDC-AI/Pixelle-Video.svg?style=flat-square)](https://github.com/AIDC-AI/Pixelle-Video/stargazers)
[![Issues](https://img.shields.io/github/issues/AIDC-AI/Pixelle-Video.svg?style=flat-square)](https://github.com/AIDC-AI/Pixelle-Video/issues)
[![License](https://img.shields.io/github/license/AIDC-AI/Pixelle-Video.svg?style=flat-square)](https://github.com/AIDC-AI/Pixelle-Video/blob/main/LICENSE)

</div>

---

## 🎯 Overview

Simply input a **topic**, and Pixelle-Video will automatically:

- ✍️ Write video scripts
- 🎨 Generate AI images  
- 🗣️ Synthesize voice narration
- 🎵 Add background music
- 🎬 Create the final video

**No barriers, no video editing experience required** - turn video creation into a one-line task!

---

## ✨ Features

- ✅ **Fully Automated** - Input a topic, get a complete video in 3 minutes
- ✅ **AI-Powered Scripts** - Intelligently create narration based on your topic
- ✅ **AI-Generated Images** - Each sentence comes with beautiful AI illustrations
- ✅ **AI Voice Synthesis** - Support for Edge-TTS, Index-TTS and more mainstream TTS solutions
- ✅ **Background Music** - Add BGM for enhanced atmosphere
- ✅ **Visual Styles** - Multiple templates to create unique video styles
- ✅ **Flexible Dimensions** - Support for portrait, landscape and more video sizes
- ✅ **Multiple AI Models** - Support for GPT, Qianwen, DeepSeek, Ollama, etc.
- ✅ **Flexible Composition** - Based on ComfyUI architecture, use preset workflows or customize any capability

---

## 🎬 Video Examples

!!! info "Sample Videos"
    Coming soon: Video examples will be added here

---

## 🚀 Quick Start

Ready to get started? Just three steps:

1. **[Install Pixelle-Video](getting-started/installation.md)** - Download and install the project
   - 🪟 **Windows Users (Recommended)**: Use the [All-in-One Package](https://github.com/AIDC-AI/Pixelle-Video/releases/latest), no Python installation required
   - 💻 **macOS/Linux Users**: Install from source, see [Installation Guide](getting-started/installation.md)
2. **[Configure Services](getting-started/configuration.md)** - Set up LLM and image generation services
3. **[Create Your First Video](getting-started/quick-start.md)** - Start creating your first video

---

## 💰 Pricing

!!! success "Completely free to run!"
    
    - **Completely Free**: Use Ollama (local) + Local ComfyUI = $0
    - **Recommended**: Use Qianwen LLM (≈$0.01-0.05 per 3-scene video) + Local ComfyUI
    - **Cloud Solution**: Use OpenAI + RunningHub (higher cost but no local setup required)
    
    **Recommendation**: If you have a local GPU, go with the completely free solution. Otherwise, we recommend Qianwen for best value.

---

## 🤝 Acknowledgments

Pixelle-Video was inspired by the following excellent open source projects:

- [Pixelle-MCP](https://github.com/AIDC-AI/Pixelle-MCP) - ComfyUI MCP server
- [MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo) - Excellent video generation tool
- [NarratoAI](https://github.com/linyqh/NarratoAI) - Video narration automation tool
- [MoneyPrinterPlus](https://github.com/ddean2009/MoneyPrinterPlus) - Video creation platform
- [ComfyKit](https://github.com/puke3615/ComfyKit) - ComfyUI workflow wrapper library

Thanks to these projects for their open source spirit! 🙏

---

## 📢 Feedback & Support

- 🐛 **Found a bug**: Submit an [Issue](https://github.com/AIDC-AI/Pixelle-Video/issues)
- 💡 **Feature request**: Submit a [Feature Request](https://github.com/AIDC-AI/Pixelle-Video/issues)
- ⭐ **Give us a Star**: If this project helps you, please give us a star!

---

## 📝 License

This project is licensed under the Apache License 2.0. See the [LICENSE](https://github.com/AIDC-AI/Pixelle-Video/blob/main/LICENSE) file for details.

