GitHub  |  Gitee  |  Atomgit Atomgit

简体中文 | 繁體中文 | English | ไทย | Tiếng Việt | 日本語 | Русский

Toonflow Logo # Toonflow

โรงงานละครสั้น AI
แตะเพียงครั้งเดียว นิยายกลายเป็นตอนทันที!
สคริปต์ AI × ภาพ AI × สร้างเร็วสายฟ้าแลบ 🔥

Stars Badge Apache-2.0 License Badge release

> 🚀 **ผลิตละครสั้นครบวงจร:** จากข้อความสู่นักแสดง จากสตอรี่บอร์ดสู่วิดีโอ AI แบบเต็มกระบวนการ ทุกขั้นตอน ไม่มีอุปสรรค ประสิทธิภาพสร้าง 10 เท่าขึ้นไป!
--- # 🌟 ฟีเจอร์หลัก Toonflow คือเครื่องมือคอมิกละครสั้น AI ที่ใช้เทคโนโลยี AI แปลงนิยายเป็นสคริปต์โดยอัตโนมัติ และใช้ภาพและวิดีโอ AI เพื่อสร้างละครสั้นได้อย่างมีประสิทธิภาพ ด้วย Toonflow คุณสามารถสร้างผลงานจากข้อความสู่ภาพนิ่งจนถึงวิดีโอ ได้อย่างชาญฉลาดและสะดวก - ✅ **สร้างตัวละครอัตโนมัติ** วิเคราะห์เนื้อหานิยายต้นฉบับ ระบุและสร้างข้อมูลตัวละครอย่างชาญฉลาด ทั้งรูปร่าง นิสัย ตัวตน เป็นต้น สร้างพื้นฐานที่แข็งแรงสำหรับสคริปต์และภาพในขั้นถัดไป - ✅ **สร้างสคริปต์อัตโนมัติ** จากเหตุการณ์และบทที่เลือก ระบบจะสร้างสคริปต์เชิงโครงสร้างอัตโนมัติ ครอบคลุมบทสนทนา คำบรรยายฉาก และทิศทางเนื้อเรื่อง เปลี่ยนข้อความวรรณกรรมเป็นสคริปต์ละครได้อย่างรวดเร็ว - ✅ **ผลิตสตอรี่บอร์ดอัตโนมัติ** ตามสคริปต์ สร้างพรอมต์สตอรี่บอร์ดและงานออกแบบภาพอัตโนมัติ รายละเอียดองค์ประกอบหน้า/กลาง/หลัง การเคลื่อนไหวตัวละคร อุปกรณ์ประกอบฉาก และการจัดวางฉาก พลิกสคริปต์เป็นสตอรี่บอร์ดวางแผนผลิตวิดีโอได้ครบถ้วน - ✅ **ประกอบวิดีโอด้วย AI** ผนวกเทคโนโลยีภาพและวิดีโอ AI สร้างคลิปวิดีโอด้วย AI รวมฟีเจอร์แก้ไขออนไลน์ รองรับการตั้งค่าผลลัพธ์ที่ปรับแต่งได้ ทำให้การสร้างภาพยนตร์/ละครมีประสิทธิภาพและทำงานร่วมทีมได้ --- # 📦 ตัวอย่างการใช้งาน - สร้างวิดีโอละครสั้น - ทดลองแปลงนิยายสู่ภาพยนตร์/ละคร - เครื่องมือดัดแปลงวรรณกรรมด้วย AI - การพัฒนาสคริปต์และต้นแบบผลิตงานเร็ว - สร้างวัตถุดิบประกอบวิดีโอ --- # 🔰 คู่มือผู้ใช้ ## 📺 วิดีโอสอนใช้งาน https://www.bilibili.com/video/BV1na6wB6Ea2 [![Toonflow 8-Minute Quick Start AI Video](./videoCover.png)](https://www.bilibili.com/video/BV1na6wB6Ea2) **วิดีโอแนะนำ Toonflow ฉบับเร่งด่วน 8 นาที** 👉 [คลิกเพื่อรับชม](https://www.bilibili.com/video/BV1na6wB6Ea2/?share_source=copy_web&vd_source=5b718c25439a901a34c7bc0c1d35b38e) 📱 สแกนด้วย WeChat บนมือถือเพื่อชม Scan WeChat to Watch --- # 🚀 การติดตั้ง ## สิ่งที่ต้องเตรียมก่อน ก่อนติดตั้งและใช้งานซอฟต์แวร์นี้ กรุณาเตรียมสิ่งเหล่านี้: - ✅ ที่อยู่ API บริการ AI แบบ Large Language Model - ✅ ที่อยู่ API บริการวิดีโอ Sora หรือ Doubao - ✅ ที่อยู่ API โมเดลสร้างภาพ Nano Banana Pro ## ติดตั้งในเครื่อง (Local Installation) ### 1. ดาวน์โหลดและติดตั้ง | ระบบปฏิบัติการ | ดาวน์โหลดจาก GitHub | ดาวน์โหลดผ่าน Quark Cloud | หมายเหตุ | | :--------------: | :------------------------------------------------------------ | :----------------------------------------------- | :------------- | | Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | ตัวติดตั้งอย่างเป็นทางการ | | Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | ตัวติดตั้งอย่างเป็นทางการ | | macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | [Quark Cloud](https://pan.quark.cn/s/94ef07509df0) | ตัวติดตั้งอย่างเป็นทางการ | > [!CAUTION] > บน MacOS ให้ไปที่ ตั้งค่า - ความเป็นส่วนตัวและความปลอดภัย ตั้งค่าความปลอดภัยก่อน มิฉะนั้นอาจไม่สามารถเปิดแอปได้เพราะปัญหาใบรับรอง > > ดูเอกสารฉบับภาษาจีน: [https://www.zhihu.com/question/433389276](https://www.zhihu.com/question/433389276) > ด้วยข้อจำกัดของสภาพแวดล้อม Gitee OS และขนาดไฟล์ Release การดาวน์โหลดผ่าน Gitee Release ยังไม่เปิดให้บริการในขณะนี้ ### 2. เปิดใช้งานโปรแกรม ติดตั้งเสร็จแล้วให้เปิดโปรแกรมเพื่อเริ่มใช้งาน > ⚠️ **ล็อกอินครั้งแรก** > ชื่อผู้ใช้: `admin` > รหัสผ่าน: `admin123` ## การใช้ Docker ### สิ่งที่ต้องเตรียม - ติดตั้ง [Docker](https://docs.docker.com/get-docker/) (เวอร์ชัน 20.10+) ### วิธีที่ 1: ติดตั้งออนไลน์ กำลังพัฒนา; ขณะนี้ให้ใช้การ build ในเครื่อง ### วิธีที่ 2: สร้างเองในเครื่อง สำหรับนักพัฒนา หรือผู้ที่ clone repo แล้ว ต้องติดตั้ง Git ที่เครื่อง ```shell # clone โปรเจกต์ (ถ้าทำแล้วข้าม) git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app # สร้างและเริ่มผ่าน docker-compose yarn docker:local # หรือสร้างแบบ manual docker build -t toonflow . docker run -d -p :10588 -v :/app/data toonflow # ใช้งานที่ /web/index.html ในพอร์ตที่แม็ปไว้ เช่น # http://localhost:10588/web/index.html ``` ### รายละเอียดพอร์ตบริการ | พอร์ต | วัตถุประสงค์ | Mapping ในการติดตั้ง | | -------- | ------------ | -------------------- | | `10588` | ส่วนติดต่อแอป | `10588:10588` | **รายละเอียดตัวแปรแวดล้อม:** | ตัวแปร | รายละเอียด | | ------------- | ----------------------------------------- | | `NODE_ENV` | สภาพแวดล้อม เลือก `prod` คือ production | | `PORT` | พอร์ตการฟังบริการ (ค่าเริ่มต้น 10588) | | `OSSURL` | ที่อยู่สำหรับเข้าถึงไฟล์ static | --- ## ติดตั้งบน Cloud ### 1. ข้อกำหนดเครื่องเซิร์ฟเวอร์ - **ระบบปฏิบัติการ:** Ubuntu 20.04+ / CentOS 7+ - **Node.js:** 24.x (แนะนำ ขั้นต่ำ 23.11.1+) - **RAM:** 2GB ขึ้นไป ### 2. วิธีติดตั้ง #### 1. ติดตั้งสภาพแวดล้อม ```bash # ติดตั้ง Node.js curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 24 # ติดตั้ง Yarn และ PM2 npm install -g yarn pm2 ``` #### 2. ติดตั้งโปรเจกต์ **Clone จาก GitHub:** ```bash cd /opt git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app yarn install yarn build ``` **Clone จาก Gitee (แนะนำในจีนแผ่นดินใหญ่):** ```bash cd /opt git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app yarn install yarn build ``` #### 3. ตั้งค่า PM2 สร้างไฟล์ `pm2.json`: ```json { "name": "toonflow-app", "script": "data/serve/app.js", "instances": "max", "exec_mode": "cluster", "env": { "NODE_ENV": "prod", "PORT": 10588, "OSSURL": "http://127.0.0.1:10588/" } } ``` **รายละเอียดตัวแปรแวดล้อม:** | ตัวแปร | รายละเอียด | | ------------- | ---------------------------------------- | | `NODE_ENV` | สภาพแวดล้อม เลือก `prod` คือ production | | `PORT` | พอร์ตให้บริการ | | `OSSURL` | ที่อยู่สำหรับเข้าถึงไฟล์ static | --- #### 4. เริ่มบริการ ```bash pm2 start pm2.json pm2 startup pm2 save ``` #### 5. คำสั่งที่ใช้บ่อย ```bash pm2 list # ดูรายชื่อโปรเซส pm2 logs toonflow-app # ดู Log pm2 restart all # รีสตาร์ทบริการ pm2 monit # ดูระบบแบบเรียลไทม์ ``` > ⚠️ **ล็อกอินครั้งแรก** > ชื่อผู้ใช้: `admin` > รหัสผ่าน: `admin123` #### 6. ติดตั้งส่วนหน้าเว็บไซต์ ถ้าต้องการใช้ Frontend แยก หรือปรับแต่ UI ศึกษาที่ repo ส่วน frontend: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) > 💡 **หมายเหตุ:** รีโปนี้ใส่ frontend ที่ compile แล้วมาด้วย ผู้ใช้ทั่วไปไม่จำเป็นต้องติดตั้ง frontend แยก Repo frontend ใช้สำหรับนักพัฒนาที่ต้องการพัฒนาต่อ --- # 🔧 คู่มือนักพัฒนา > [!CAUTION] > 🚧 **แนวทางการส่ง PR** 🚧 > > ⛔ `master` ไม่รับ PR | ✅ ส่ง PR ที่ `develop` > > เชิญนักพัฒนาร่วมพัฒนา Toonflow ติดต่อเจ้าของ ACT ในแชทกลุ่ม ## 🛠️ Tech Stack | หมวด | เทคโนโลยี | | ------------ | ------------------------------------------------------------------------------------ | | Runtime | Node.js 23.11.1+ | | Language | TypeScript 5.x | | Backend | Express 5 | | Database | SQLite (better-sqlite3 / knex) | | AI Integration | Vercel AI SDK (OpenAI / Anthropic / Google / DeepSeek / Zhipu / MiniMax / Qwen / xAI) | | Local Inference | @huggingface/transformers (ONNX) | | Real-Time | Socket.IO | | Desktop | Electron 40 | | Image Proc. | Sharp | | Container | Docker | ## เตรียมสภาพแวดล้อม - **Node.js:** ต้องใช้ 23.11.1 ขึ้นไปเท่านั้น - **Yarn:** แนะนำให้ใช้เป็น package manager ## เริ่มพัฒนาอย่างรวดเร็ว 1. **Clone โปรเจกต์** **GitHub:** ```bash git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` **Gitee (ในจีนแผ่นดินใหญ่แนะนำ):** ```bash git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app ``` 2. **ติดตั้ง dependencies** รันที่ root directory: ```bash yarn install ``` 3. **เริ่มสภาพแวดล้อมพัฒนา** โปรเจกต์นี้มี **backend API service** และ **frontend interface** เลือกวิธีเริ่มต้นได้: - **ตัวเลือก 1: เริ่ม backend อย่างเดียว** ```bash yarn dev ``` > ⚠️ คำสั่งนี้เปิดเฉพาะ backend API (พอร์ต 10588) **ไม่มี web UI** การเข้า http://localhost:10588 คือเรียก API เท่านั้น การใช้ web UI เต็มรูปแบบใช้วิธีด้านล่าง - **ตัวเลือก 2: เริ่ม Electron desktop client** ```bash yarn dev:gui ``` > คำสั่งนี้เปิดทั้ง backend และ Electron window มี web UI built-in พร้อมใช้งาน - **ตัวเลือก 3: โหมด production** ```bash yarn start ``` > รันทั้ง backend แบบโปรดักชั่น (ต้อง `yarn build` ก่อน) 4. **คอมไพล์โปรเจกต์** - คอมไพล์ TypeScript: ```bash yarn build ``` - สร้าง executable สำหรับ Windows: ```bash yarn dist:win ``` - สร้าง executable สำหรับ Mac: ```bash yarn dist:mac ``` - สร้าง executable สำหรับ Linux: ```bash yarn dist:linux ``` 5. **ตรวจสอบคุณภาพโค้ด** - เช็ค lint: ```bash yarn lint ``` 6. **AI Debug panel (ไม่บังคับ)** รัน Visual Debugging Tool ของ Vercel AI SDK เพื่อ debug integration AI ได้ง่ายขึ้น: ```bash yarn debug:ai ``` ## การพัฒนา Frontend หากต้องการพัฒนา UI แก้ไขที่ frontend repo: - **GitHub**: [Toonflow-web](https://github.com/HBAI-Ltd/Toonflow-web) - **Gitee**: [Toonflow-web](https://gitee.com/HBAI-Ltd/Toonflow-web) หลัง build frontend แล้ว ให้นำไฟล์ใน `dist` ไปวางใน `data/web` ของโปรเจกต์นี้ ## โครงสร้างโปรเจกต์ ``` 📂 build/ # ผลลัพธ์หลังคอมไพล์ 📂 data/ # ข้อมูล runtime │ ├─ 📂 models/ # โมเดล inference ในเครื่อง (ONNX) │ ├─ 📂 oss/ # ที่เก็บวัตถุ (assets/character/scene) │ ├─ 📂 serve/ # จุดเริ่ม production │ ├─ 📂 skills/ # เอเจนท์พรอมต์ทักษะต่างๆ │ └─ 📂 web/ # asset frontend ที่มาในตัว 📂 ./ # เอกสาร 📂 env/ # ไฟล์ config environment 📂 scripts/ # script สร้างและช่วยงาน 📂 src/ ├─ 📂 agents/ # โมดูล AI Agent ต่างๆ │ ├─ 📂 productionAgent/ # เอเจนท์ผลิตงาน │ └─ 📂 scriptAgent/ # เอเจนท์สคริปต์ ├─ 📂 lib/ # ไลบรารีทั่วไป (db, response) ├─ 📂 middleware/ # Middleware ต่างๆ ├─ 📂 routes/ # เส้นทาง API หลัก │ ├─ 📂 agents/ # จัดการความจำเอเจนท์ │ ├─ 📂 artStyle/ # จัดการสไตล์ศิลปะ │ ├─ 📂 assets/ # จัดการ asset │ ├─ 📂 assetsGenerate/ # สร้าง asset อัตโนมัติ │ ├─ 📂 cornerScape/ # จัดการสตอรี่บอร์ด │ ├─ 📂 general/ # API ทั่วไป │ ├─ 📂 login/ # ยืนยันตัวตนเข้าใช้ │ ├─ 📂 migrate/ # ย้ายโครงสร้างข้อมูล │ ├─ 📂 modelSelect/ # จัดการเลือกโมเดล │ ├─ 📂 novel/ # จัดการนิยาย │ ├─ 📂 other/ # ฟีเจอร์อื่นๆ │ ├─ 📂 production/ # จัดการการผลิต │ ├─ 📂 project/ # จัดการโปรเจกต์ │ ├─ 📂 script/ # สร้างสคริปต์ │ ├─ 📂 scriptAgent/ # Endpoint AI Agent สคริปต์ │ ├─ 📂 setting/ # ตั้งค่าระบบ │ ├─ 📂 task/ # จัดการงาน │ └─ 📂 test/ # ทดสอบ API ├─ 📂 socket/ # การสื่อสาร WebSocket ├─ 📂 types/ # TypeScript type definitions ├─ 📂 utils/ # ฟังก์ชันอรรถประโยชน์ ├─ 📄 app.ts # จุดเข้าแอป ├─ 📄 core.ts # core initialization ├─ 📄 env.ts # ตัวแปร env ├─ 📄 err.ts # จัดการ error ├─ 📄 logger.ts # log โมดูล ├─ 📄 router.ts # ลงทะเบียน route ต่าง ๆ └─ 📄 utils.ts # เครื่องมือทั่วไป 📄 Dockerfile # config สำหรับ docker build 📄 electron-builder.yml # config แพ็ค Electron 📄 skillList.json # รายการทักษะ 📄 LICENSE # ใบอนุญาต Apache-2.0 📄 NOTICES.txt # รายงานไลบรารีที่ใช้ 📄 package.json # config โปรเจกต์ 📄 tsconfig.json # TypeScript config ``` --- # 🔗 รีโพที่เกี่ยวข้อง | รีโพ | คำอธิบาย | GitHub | Gitee | | ------------ | ----------------- | ----------------------------------------------- | -------------------------------------------- | | **Toonflow-app** | ตัวเต็ม (รีโปนี้, สำหรับผู้ใช้) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-app) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-app) | | **Toonflow-web** | ซอร์ส frontend (สำหรับ dev FE) | [GitHub](https://github.com/HBAI-Ltd/Toonflow-web) | [Gitee](https://gitee.com/HBAI-Ltd/Toonflow-web) | > 💡 **หมายเหตุ:** ถ้าแค่ต้องการใช้งาน ดาวน์โหลดไคลเอนต์จากรีโปนี้ได้เลย รีโป frontend เหมาะสำหรับ dev ที่จะพัฒนา UI ต่อ --- # 👨‍👩‍👧‍👦 กลุ่ม WeChat ~~กลุ่ม 1~~ ~~กลุ่ม 2~~ ... ~~กลุ่ม 10~~ ~~กลุ่ม 11~~ ~~กลุ่ม 12~~ ~~กลุ่ม 13~~ ... ~~กลุ่ม 24~~ ผู้ช่วยกลุ่ม: Toonflow QR --- # 💌 ติดต่อเรา 📧 อีเมล: [ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow inquiry) --- # 📜 ใบอนุญาต Toonflow เป็นโอเพ่นซอร์สภายใต้ Apache-2.0 รายละเอียดที่: https://www.apache.org/licenses/LICENSE-2.0 สามารถใช้งาน Toonflow ได้ทุกวัตถุประสงค์ ไม่เว้นเชิงพาณิชย์ ตราบเท่าที่ปฏิบัติตาม Apache-2.0 --- # ⭐️ ประวัติการกดดาว [![Star History Chart](https://api.star-history.com/svg?repos=HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left)](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&type=timeline&legend=top-left) --- # 🙏 ขอขอบคุณ ขอบคุณโอเพ่นซอร์สต่อไปนี้ที่สนับสนุน Toonflow: - [Express](https://expressjs.com/) - เฟรมเวิร์ก Node.js ที่เร็ว เล็ก และเปิดกว้าง - [AI SDK](https://ai-sdk.dev/) - ชุดเครื่องมือ AI-first สำหรับ TypeScript - [Better-SQLite3](https://github.com/WiseLibs/better-sqlite3) - Binding SQLite3 ประสิทธิภาพสูง - [Sharp](https://sharp.pixelplumbing.com/) - ไลบรารีจัดการภาพบน Node.js ประสิทธิภาพสูง - [Axios](https://axios-http.com/) - HTTP client แบบ Promise - [Zod](https://zod.dev/) - ไลบรารีตรวจสอบชนิด TypeScript เป็นหลัก - [Socket.IO](https://socket.io/) - เฟรมเวิร์ก event bidirectional แบบเรียลไทม์ - [Electron](https://www.electronjs.org/) - เฟรมเวิร์กสร้างแอปเดสก์ท็อปข้ามแพลตฟอร์ม - [Hugging Face Transformers](https://huggingface.co./transformers.js) - ไลบรารี ML inference ในเครื่อง ขอบคุณองค์กร/บุคคลต่อไปนี้สนับสนุน Toonflow:
SophNet Logo SophNet Cloud เป็นผู้สนับสนุนทรัพยากรการประมวลผล [เว็บไซต์]
รายชื่อไลบรารีภายนอกทั้งหมด ดูได้ที่ `NOTICES.txt`