AI-Powered Content Script Generator CLI Tool
AI้ฉฑๅจ็็ญ่ง้ข/ๅ
ๅฎน่ๆฌ่ชๅจ็ๆๅฝไปค่กๅทฅๅ
ท
Generate viral video scripts in seconds, not hours.
็ฎไฝไธญๆ โข ็น้ซไธญๆ โข English
ScriptForge ๆฏไธๆฌพ่ฝป้็บงใ้ถไพ่ต็AI้ฉฑๅจๅ ๅฎน่ๆฌ็ๆCLIๅทฅๅ ทใๆ ่ฎบไฝ ๆฏ็ญ่ง้ขๅไฝ่ ใๅ ๅฎน่ฟ่ฅ่ฟๆฏ่ชๅชไฝไปไธ่ ๏ผScriptForge้ฝ่ฝๅธฎไฝ ๅฟซ้็ๆ้ซ่ดจ้็็ญ่ง้ข่ๆฌใๅ้ๆนๆกๅๅญๅนๆไปถใ
ๅ่ไบGitHub Trendingไธ็ญ้จ็AI่ง้ข็ๆๅทฅๅ ท๏ผๅฆPixelle-Video็ญ๏ผ็่ๆฌ็ๆ็ฏ่๏ผ็ฌ็ซ่ช็ ไบ่ฟๆฌพไธๆณจไบ่ๆฌๅไฝ็่ฝป้็บงๅทฅๅ ทใไธ้่ฆๅคๆ็ฏๅข้ ็ฝฎ็ๅ จๆ ่ง้ขๅทฅๅ ทไธๅ๏ผScriptForgeไธๆณจไบๅๅฅฝไธไปถไบโโๅธฎไฝ ๅๅบ็ๆฌพ่ๆฌใ
- ้ถๅค้จไพ่ต๏ผๆ ธๅฟๅ่ฝไป ไฝฟ็จPythonๆ ๅๅบ๏ผๆ ้ๅฎ่ฃ ไปปไฝ็ฌฌไธๆนๅ
- ๅคๅนณๅฐ้้ ๏ผๅ ็ฝฎๆ้ณ/TikTokใYouTube ShortsใB็ซใๅฐ็บขไนฆใInstagram Reelsๆจกๆฟ
- ๅคLLMๅ็ซฏ๏ผๆฏๆOpenAIใAnthropic ClaudeใOllamaๆฌๅฐๆจกๅๅไปปไฝOpenAIๅ ผๅฎนAPI
- ๆบ่ฝ่ฏๅ็ณป็ป๏ผ7็ปดๅบฆ่ๆฌ่ดจ้่ฏไผฐ๏ผๅธฎไฝ ไผๅๆฏไธไธช็ป่
- ๅคๆ ผๅผๅฏผๅบ๏ผMarkdownใJSONใSRTๅญๅนใ็บฏๆๆฌ๏ผไธ้ฎๅๆข
- ๅ ็ฝฎMockๆจกๅผ๏ผๆ ้API Keyๅณๅฏไฝ้ชๅ จ้จๅ่ฝ๏ผๆนไพฟๆต่ฏๅๆผ็คบ
| ็นๆง | ๆ่ฟฐ |
|---|---|
| ๐ฌ ๅคๅนณๅฐๆจกๆฟ | ๅ ็ฝฎ8+ๅนณๅฐๆจกๆฟ๏ผๆ้ณ15s/30s/60sใYouTubeใB็ซใๅฐ็บขไนฆใInstagram็ญ๏ผ |
| ๐ค AI่ๆฌ็ๆ | ๆฅๅ ฅGPT-4o/Claude/Ollama็ญๅคงๆจกๅ๏ผๆบ่ฝ็ๆไธไธ่ๆฌ |
| ๐ 7็ปด่ดจ้่ฏๅ | ้ฉๅญๅผบๅบฆใ็ปๆใไบๅจๆงใๆธ ๆฐๅบฆใๅนณๅฐ้้ ใCTAๆๆใๆ ็ญพ็ธๅ ณๆง |
| ๐ SRTๅญๅน็ๆ | ่ชๅจ็ๆๅธฆๆถ้ด่ฝด็SRTๅญๅนๆไปถ๏ผๅฏ็ดๆฅ็จไบ่ง้ขๅช่พ |
| ๐ฅ ็ญ็น่ฏ้ขๆจ่ | ๅ ็ฝฎ6ๅคงๅ็ฑป๏ผ็งๆ/็ๆดป/ๆ่ฒ/ๅไธ/ๅจฑไน/็ปผๅ๏ผ็ญ้จ่ฏ้ขๅบ |
| ๐ฆ ๆน้็ๆ | ไป่ฏ้ขๆไปถๆน้็ๆ่ๆฌ๏ผๆฏๆๅคง่งๆจกๅ ๅฎน็ไบง |
| ๐ ๅค่ฏญ่จ่พๅบ | ๆฏๆไธญๆใ่ฑๆใๆฅๆใ้ฉๆใ่ฅฟ็ญ็ๆ่ๆฌ็ๆ |
| ๐จ 6็ง้ฃๆ ผ | ไบๅจๅใๆ่ฒๅใๅจฑไนๅใๅฑๅฟๅใๅไบๅใๆจๅนฟๅ |
| ๐ค 4็งๅฏผๅบๆ ผๅผ | MarkdownใJSONใSRTๅญๅนใ็บฏๆๆฌ |
| โ๏ธ YAML้ ็ฝฎ | ็ตๆดป็YAML้ ็ฝฎๆไปถ๏ผๆฏๆ็ฏๅขๅ้่ฆ็ |
| ๐งช Mockๆจกๅผ | ๅ ็ฝฎๆจกๆ็ๆๅจ๏ผๆ ้API Keyๅณๅฏๅฎๆดไฝ้ช |
- Python 3.9 ๆๆด้ซ็ๆฌ
- pip ๅ ็ฎก็ๅจ
- ๏ผๅฏ้๏ผOpenAI / Anthropic API Key๏ผๆๆฌๅฐๅฎ่ฃ Ollama
# ไปPyPIๅฎ่ฃ
๏ผๆจ่๏ผ
pip install scriptforge
# ๆไปๆบ็ ๅฎ่ฃ
git clone https://github.com/gitstq/scriptforge.git
cd scriptforge
pip install -e .# 1. ๆฅ็ๅธฎๅฉ
scriptforge --help
# 2. ไฝฟ็จMockๆจกๅผ็ๆ่ๆฌ๏ผๆ ้API Key๏ผ
scriptforge generate "5ไธชPythonๆฐๆๅฟ
็ฅๆๅทง" --platform tiktok --duration 15
# 3. ๆฅ็ๅฏ็จๆจกๆฟ
scriptforge templates
# 4. ๆฅ็็ญ้จ่ฏ้ขๆจ่
scriptforge trending --category tech --count 5
# 5. ๅฏผๅบไธบMarkdown
scriptforge generate "AIๅทฅๅ
ทๆจ่" --platform youtube --duration 60 --output script.md
# 6. ๅฏผๅบไธบSRTๅญๅน
scriptforge generate "็ๆดปๅฐๅฆๆ" --platform xiaohongshu --format srt --output subtitles.srt
# 7. ๆน้็ๆ
scriptforge batch --topics-file topics.txt --output-dir ./scripts --platform tiktok
# 8. ๅๅงๅ้กน็ฎ
scriptforge init my-video-projectๅๅปบ้
็ฝฎๆไปถ scriptforge.yaml๏ผ
# ไฝฟ็จOpenAI
provider:
name: openai
api_key: sk-your-key-here
model: gpt-4o-mini
# ๆไฝฟ็จAnthropic Claude
# provider:
# name: anthropic
# api_key: sk-ant-your-key-here
# model: claude-sonnet-4-20250514
# ๆไฝฟ็จๆฌๅฐOllama๏ผๅฎๅ
จๅ
่ดน๏ผ
# provider:
# name: ollama
# model: llama3
# base_url: http://localhost:11434
# ๆไฝฟ็จ็ฏๅขๅ้
# export OPENAI_API_KEY=sk-your-key-here
# export SCRIPTFORGE_PROVIDER=ollama| ๆจกๆฟๅ็งฐ | ๅนณๅฐ | ๆถ้ฟ | ้็จๅบๆฏ |
|---|---|---|---|
tiktok-15s |
ๆ้ณ/TikTok | 15็ง | ๅฟซ้้ฉๅญ่ง้ข |
tiktok-30s |
ๆ้ณ/TikTok | 30็ง | ไธญ็ญๅ ๅฎน่ง้ข |
tiktok-60s |
ๆ้ณ/TikTok | 60็ง | ๆทฑๅบฆๅ ๅฎน่ง้ข |
youtube-60s |
YouTube Shorts | 60็ง | ็ฅ่ฏๅไบซ |
bilibili-60s |
B็ซ | 60็ง | ๆทฑๅบฆๅ ๅฎน |
xiaohongshu-30s |
ๅฐ็บขไนฆ | 30็ง | ็ง่ๆจ่ |
instagram-30s |
Instagram Reels | 30็ง | ็ๆดปๆนๅผ |
generic-30s |
้็จ | 30็ง | ๅคๅนณๅฐๅๅ |
๐ Script Quality Scores
hook_strength โโโโโโโโโโ 85% A ๐ฃ ้ฉๅญๅธๅผๅ
structure โโโโโโโโโโ 95% A+ ๐ ็ปๆๅฎๆดๆง
engagement โโโโโโโโโโ 75% B ๐ฌ ไบๅจๆฝๅ
clarity โโโโโโโโโโ 80% A ๐ ๅ
ๅฎนๆธ
ๆฐๅบฆ
platform_fit โโโโโโโโโโ 90% A+ ๐ฑ ๅนณๅฐ้้
ๅบฆ
cta_effectiveness โโโโโโโโโโ 70% B ๐ข CTAๆๆ
hashtag_relevance โโโโโโโโโโ 85% A ๐ท๏ธ ๆ ็ญพ็ธๅ
ณๆง
overall โโโโโโโโโโ 83% A ๐ ็ปผๅ่ฏๅ
- ้ถไพ่ตๆ ธๅฟ๏ผไธไพ่ตไปปไฝ็ฌฌไธๆนๅบ๏ผ้ไฝๅฎ่ฃ ้จๆง๏ผๆๅ็จณๅฎๆง
- ้ ็ฝฎ้ฉฑๅจ๏ผYAML้ ็ฝฎๆไปถ + ็ฏๅขๅ้๏ผ็ตๆดป้้ ไธๅไฝฟ็จๅบๆฏ
- ๆจกๆฟๅ๏ผๅนณๅฐๆจกๆฟ็ณป็ป๏ผ่ฎฉ่ๆฌ็ปๆ็ฌฆๅๅๅนณๅฐๆไฝณๅฎ่ทต
- ๅฏๆฉๅฑ๏ผๆธ ๆฐ็ๆจกๅๆถๆ๏ผๆนไพฟๆทปๅ ๆฐ็ๅนณๅฐๆจกๆฟใLLMๅ็ซฏๅๅฏผๅบๆ ผๅผ
- Python 3.9+๏ผๅนฟๆณๅ ผๅฎน๏ผๆ ๅๅบไธฐๅฏ
- urllib๏ผๆฟไปฃrequests๏ผๅฎ็ฐ้ถไพ่ตHTTP่ฏทๆฑ
- ๅ ็ฝฎYAML่งฃๆๅจ๏ผๆฟไปฃPyYAML๏ผ็ฎๅไพ่ต
- ๅ ็ฝฎๆจกๆฟๅผๆ๏ผๆฟไปฃJinja2๏ผไฟๆ่ฝป้
- ๐ฅ ่ง้ขๅ้ๅพ่ชๅจ็ๆ๏ผ้ๆๅพ็็ๆAPI๏ผ
- ๐ ่ๆฌA/Bๆต่ฏๅฏนๆฏๅ่ฝ
- ๐ ๅๅฒ่ๆฌ็ฎก็ไธ็ๆฌๅฏนๆฏ
- ๐ ๆดๅค่ฏญ่จๆฏๆ๏ผๆณ่ฏญใๅพท่ฏญใ้ฟๆไผฏ่ฏญ็ญ๏ผ
- ๐ฑ Web UI็้ข
- ๐ ไธ่ง้ขๅช่พๅทฅๅ ท้ๆ๏ผFFmpegใๅชๆ ็ญ๏ผ
pip install scriptforgegit clone https://github.com/gitstq/scriptforge.git
cd scriptforge
pip install -e .docker build -t scriptforge .
docker run -it scriptforge generate "AIๅทฅๅ
ทๆจ่" --platform tiktok| ็ฏๅข | ๆไฝ็ๆฌ | ๆจ่็ๆฌ |
|---|---|---|
| Python | 3.9 | 3.11+ |
| ๆไฝ็ณป็ป | Windows/macOS/Linux | ไปปๆ |
| Ollama๏ผๅฏ้๏ผ | 0.1.0 | ๆๆฐ็ |
ๆฌข่ฟ่ดก็ฎไปฃ็ ๏ผ่ฏท้ตๅพชไปฅไธๆญฅ้ชค๏ผ
- Fork ๆฌไปๅบ
- ๅๅปบๅ่ฝๅๆฏ๏ผ
git checkout -b feat/your-feature - ็ผๅไปฃ็ ๅๆต่ฏ
- ็กฎไฟๆๆๆต่ฏ้่ฟ๏ผ
python -m unittest discover tests/ - ๆไบคไปฃ็ ๏ผ
git commit -m "feat: ๆทปๅ ไฝ ็ๅ่ฝ" - ๆจ้ๅๆฏ๏ผ
git push origin feat/your-feature - ๆไบคPull Request
่ฏฆ็ปๆๅ่ฏทๅ้ CONTRIBUTING.mdใ
ๆฌ้กน็ฎๅบไบ MIT License ๅผๆบใ
Made with โค๏ธ by gitstq
ScriptForge ๆฏไธๆฌพ่ผ้็ดใ้ถไพ่ณด็AI้ฉ ๅๅ งๅฎน่ ณๆฌ็ๆCLIๅทฅๅ ทใ็ก่ซไฝ ๆฏ็ญ่ฆ้ ปๅตไฝ่ ใๅ งๅฎน้็้ๆฏ่ชๅช้ซๅพๆฅญ่ ๏ผScriptForge้ฝ่ฝๅนซไฝ ๅฟซ้็ๆ้ซ่ณช้็็ญ่ฆ้ ป่ ณๆฌใๅ้กๆนๆกๅๅญๅนๆไปถใ
ๅ่ไบGitHub Trendingไธ็ฑ้็AI่ฆ้ ป็ๆๅทฅๅ ท๏ผๅฆPixelle-Video็ญ๏ผ็่ ณๆฌ็ๆ็ฐ็ฏ๏ผ็จ็ซ่ช็ ไบ้ๆฌพๅฐๆณจๆผ่ ณๆฌๅตไฝ็่ผ้็ดๅทฅๅ ทใ่้่ฆ่ค้็ฐๅข้ ็ฝฎ็ๅ จๆฃง่ฆ้ ปๅทฅๅ ทไธๅ๏ผScriptForgeๅฐๆณจๆผๅๅฅฝไธไปถไบโโๅนซไฝ ๅฏซๅบ็ๆฌพ่ ณๆฌใ
- ้ถๅค้จไพ่ณด๏ผๆ ธๅฟๅ่ฝๅ ไฝฟ็จPythonๆจๆบๅบซ๏ผ็ก้ๅฎ่ฃไปปไฝ็ฌฌไธๆนๅ
- ๅคๅนณๅฐ้ฉ้ ๏ผๅ ง็ฝฎๆ้ณ/TikTokใYouTube ShortsใB็ซใๅฐ็ด ๆธใInstagram Reelsๆจกๆฟ
- ๅคLLMๅพ็ซฏ๏ผๆฏๆOpenAIใAnthropic ClaudeใOllamaๆฌๅฐๆจกๅๅไปปไฝOpenAIๅ ผๅฎนAPI
- ๆบ่ฝ่ฉๅ็ณป็ตฑ๏ผ7็ถญๅบฆ่ ณๆฌ่ณช้่ฉไผฐ๏ผๅนซไฝ ๅชๅๆฏไธๅ็ดฐ็ฏ
- ๅคๆ ผๅผๅฐๅบ๏ผMarkdownใJSONใSRTๅญๅนใ็ดๆๆฌ๏ผไธ้ตๅๆ
- ๅ ง็ฝฎMockๆจกๅผ๏ผ็ก้API Keyๅณๅฏ้ซ้ฉๅ จ้จๅ่ฝ๏ผๆนไพฟๆธฌ่ฉฆๅๆผ็คบ
| ็นๆง | ๆ่ฟฐ |
|---|---|
| ๐ฌ ๅคๅนณๅฐๆจกๆฟ | ๅ ง็ฝฎ8+ๅนณๅฐๆจกๆฟ๏ผๆ้ณ15s/30s/60sใYouTubeใB็ซใๅฐ็ด ๆธใInstagram็ญ๏ผ |
| ๐ค AI่ ณๆฌ็ๆ | ๆฅๅ ฅGPT-4o/Claude/Ollama็ญๅคงๆจกๅ๏ผๆบ่ฝ็ๆๅฐๆฅญ่ ณๆฌ |
| ๐ 7็ถญ่ณช้่ฉๅ | ้คๅญๅผทๅบฆใ็ตๆงใไบๅๆงใๆธ ๆฐๅบฆใๅนณๅฐ้ฉ้ ใCTAๆๆใๆจ็ฑค็ธ้ๆง |
| ๐ SRTๅญๅน็ๆ | ่ชๅ็ๆๅธถๆ้่ปธ็SRTๅญๅนๆไปถ๏ผๅฏ็ดๆฅ็จๆผ่ฆ้ ปๅช่ผฏ |
| ๐ฅ ็ฑ้ป่ฉฑ้กๆจ่ฆ | ๅ ง็ฝฎ6ๅคงๅ้ก๏ผ็งๆ/็ๆดป/ๆ่ฒ/ๅๆฅญ/ๅจๆจ/็ถๅ๏ผ็ฑ้่ฉฑ้กๅบซ |
| ๐ฆ ๆน้็ๆ | ๅพ่ฉฑ้กๆไปถๆน้็ๆ่ ณๆฌ๏ผๆฏๆๅคง่ฆๆจกๅ งๅฎน็็ข |
| ๐ ๅค่ช่จ่ผธๅบ | ๆฏๆไธญๆใ่ฑๆใๆฅๆใ้ๆใ่ฅฟ็ญ็ๆ่ ณๆฌ็ๆ |
| ๐จ 6็จฎ้ขจๆ ผ | ไบๅๅใๆ่ฒๅใๅจๆจๅใๅตๅฟๅใๆไบๅใๆจๅปฃๅ |
| ๐ค 4็จฎๅฐๅบๆ ผๅผ | MarkdownใJSONใSRTๅญๅนใ็ดๆๆฌ |
| โ๏ธ YAML้ ็ฝฎ | ้ๆดป็YAML้ ็ฝฎๆไปถ๏ผๆฏๆ็ฐๅข่ฎ้่ฆ่ |
| ๐งช Mockๆจกๅผ | ๅ งๅปบๆจกๆฌ็ๆๅจ๏ผ็ก้API Keyๅณๅฏๅฎๆด้ซ้ฉ |
- Python 3.9 ๆๆด้ซ็ๆฌ
- pip ๅ ็ฎก็ๅจ
- ๏ผๅฏ้ธ๏ผOpenAI / Anthropic API Key๏ผๆๆฌๅฐๅฎ่ฃ Ollama
# ๅพPyPIๅฎ่ฃ๏ผๆจ่ฆ๏ผ
pip install scriptforge
# ๆๅพๆบ็ขผๅฎ่ฃ
git clone https://github.com/gitstq/scriptforge.git
cd scriptforge
pip install -e .# 1. ๆฅ็ๅนซๅฉ
scriptforge --help
# 2. ไฝฟ็จMockๆจกๅผ็ๆ่
ณๆฌ๏ผ็ก้API Key๏ผ
scriptforge generate "5ๅPythonๆฐๆๅฟ
็ฅๆๅทง" --platform tiktok --duration 15
# 3. ๆฅ็ๅฏ็จๆจกๆฟ
scriptforge templates
# 4. ๆฅ็็ฑ้่ฉฑ้กๆจ่ฆ
scriptforge trending --category tech --count 5
# 5. ๅฐๅบ็บMarkdown
scriptforge generate "AIๅทฅๅ
ทๆจ่ฆ" --platform youtube --duration 60 --output script.md
# 6. ๅฐๅบ็บSRTๅญๅน
scriptforge generate "็ๆดปๅฐๅฆๆ" --platform xiaohongshu --format srt --output subtitles.srt
# 7. ๆน้็ๆ
scriptforge batch --topics-file topics.txt --output-dir ./scripts --platform tiktok
# 8. ๅๅงๅ้
็ฎ
scriptforge init my-video-projectๅตๅปบ้
็ฝฎๆไปถ scriptforge.yaml๏ผ
# ไฝฟ็จOpenAI
provider:
name: openai
api_key: sk-your-key-here
model: gpt-4o-mini
# ๆไฝฟ็จๆฌๅฐOllama๏ผๅฎๅ
จๅ
่ฒป๏ผ
# provider:
# name: ollama
# model: llama3
# base_url: http://localhost:11434| ๆจกๆฟๅ็จฑ | ๅนณๅฐ | ๆ้ท | ้ฉ็จๅ ดๆฏ |
|---|---|---|---|
tiktok-15s |
ๆ้ณ/TikTok | 15็ง | ๅฟซ้้คๅญ่ฆ้ ป |
tiktok-30s |
ๆ้ณ/TikTok | 30็ง | ไธญ็ญๅ งๅฎน่ฆ้ ป |
tiktok-60s |
ๆ้ณ/TikTok | 60็ง | ๆทฑๅบฆๅ งๅฎน่ฆ้ ป |
youtube-60s |
YouTube Shorts | 60็ง | ็ฅ่ญๅไบซ |
bilibili-60s |
B็ซ | 60็ง | ๆทฑๅบฆๅ งๅฎน |
xiaohongshu-30s |
ๅฐ็ด ๆธ | 30็ง | ็จฎ่ๆจ่ฆ |
instagram-30s |
Instagram Reels | 30็ง | ็ๆดปๆนๅผ |
generic-30s |
้็จ | 30็ง | ๅคๅนณๅฐๅ็ผ |
- ้ถไพ่ณดๆ ธๅฟ๏ผไธไพ่ณดไปปไฝ็ฌฌไธๆนๅบซ๏ผ้ไฝๅฎ่ฃ้ๆชป๏ผๆๅ็ฉฉๅฎๆง
- ้ ็ฝฎ้ฉ ๅ๏ผYAML้ ็ฝฎๆไปถ + ็ฐๅข่ฎ้๏ผ้ๆดป้ฉ้ ไธๅไฝฟ็จๅ ดๆฏ
- ๆจกๆฟๅ๏ผๅนณๅฐๆจกๆฟ็ณป็ตฑ๏ผ่ฎ่ ณๆฌ็ตๆง็ฌฆๅๅๅนณๅฐๆไฝณๅฏฆ่ธ
- ๅฏๆดๅฑ๏ผๆธ ๆฐ็ๆจกๅกๆถๆง๏ผๆนไพฟๆทปๅ ๆฐ็ๅนณๅฐๆจกๆฟใLLMๅพ็ซฏๅๅฐๅบๆ ผๅผ
- ๐ฅ ่ฆ้ ปๅ้กๅ่ชๅ็ๆ
- ๐ ่ ณๆฌA/Bๆธฌ่ฉฆๅฐๆฏๅ่ฝ
- ๐ ๆญทๅฒ่ ณๆฌ็ฎก็่็ๆฌๅฐๆฏ
- ๐ ๆดๅค่ช่จๆฏๆ
- ๐ฑ Web UI็้ข
- ๐ ่่ฆ้ ปๅช่ผฏๅทฅๅ ท้ๆ
ๆญก่ฟ่ฒข็ปไปฃ็ขผ๏ผ่ซ้ตๅพชไปฅไธๆญฅ้ฉ๏ผ
- Fork ๆฌๅๅบซ
- ๅตๅปบๅ่ฝๅๆฏ๏ผ
git checkout -b feat/your-feature - ็ทจๅฏซไปฃ็ขผๅๆธฌ่ฉฆ
- ็ขบไฟๆๆๆธฌ่ฉฆ้้๏ผ
python -m unittest discover tests/ - ๆไบคไปฃ็ขผ๏ผ
git commit -m "feat: ๆทปๅ ไฝ ็ๅ่ฝ" - ๆจ้ๅๆฏ๏ผ
git push origin feat/your-feature - ๆไบคPull Request
ๆฌ้ ็ฎๅบๆผ MIT License ้ๆบใ
Made with โค๏ธ by gitstq
ScriptForge is a lightweight, zero-dependency AI-powered content script generator CLI tool. Whether you're a short video creator, content operator, or social media professional, ScriptForge helps you quickly generate high-quality video scripts, storyboard plans, and subtitle files.
Inspired by the script generation capabilities of trending AI video tools (like Pixelle-Video) on GitHub Trending, ScriptForge is an independently developed tool focused solely on script creation. Unlike full-stack video tools that require complex setups, ScriptForge does one thing exceptionally well โ helping you write viral scripts.
- Zero External Dependencies: Core functionality uses only Python standard library
- Multi-Platform Templates: Built-in templates for TikTok, YouTube Shorts, Bilibili, Xiaohongshu, Instagram Reels
- Multi-LLM Backend: Supports OpenAI, Anthropic Claude, Ollama local models, and any OpenAI-compatible API
- Smart Scoring System: 7-dimension script quality assessment to optimize every detail
- Multi-Format Export: Markdown, JSON, SRT subtitles, plain text โ one-click switching
- Built-in Mock Mode: Experience all features without any API key
| Feature | Description |
|---|---|
| ๐ฌ Multi-Platform Templates | 8+ built-in platform templates (TikTok 15s/30s/60s, YouTube, Bilibili, etc.) |
| ๐ค AI Script Generation | Powered by GPT-4o / Claude / Ollama for professional script creation |
| ๐ 7-Dimension Quality Scoring | Hook strength, structure, engagement, clarity, platform fit, CTA, hashtag relevance |
| ๐ SRT Subtitle Generation | Auto-generate timestamped SRT subtitle files for video editing |
| ๐ฅ Trending Topic Suggestions | Built-in topic library across 6 categories (tech, lifestyle, education, etc.) |
| ๐ฆ Batch Generation | Generate scripts in bulk from a topics file |
| ๐ Multi-Language Output | Chinese, English, Japanese, Korean, Spanish |
| ๐จ 6 Script Styles | Engaging, educational, entertaining, inspirational, storytelling, promotional |
| ๐ค 4 Export Formats | Markdown, JSON, SRT subtitles, plain text |
| โ๏ธ YAML Configuration | Flexible config files with environment variable override |
| ๐งช Mock Mode | Built-in mock generator for testing without API keys |
- Python 3.9 or higher
- pip package manager
- (Optional) OpenAI / Anthropic API key, or locally installed Ollama
# Install from PyPI (recommended)
pip install scriptforge
# Or install from source
git clone https://github.com/gitstq/scriptforge.git
cd scriptforge
pip install -e .# 1. Show help
scriptforge --help
# 2. Generate a script with Mock mode (no API key needed)
scriptforge generate "5 Python Tips Every Beginner Needs" --platform tiktok --duration 15
# 3. List available templates
scriptforge templates
# 4. Get trending topic suggestions
scriptforge trending --category tech --count 5
# 5. Export as Markdown
scriptforge generate "AI Tools You Must Try" --platform youtube --duration 60 --output script.md
# 6. Export as SRT subtitles
scriptforge generate "Life Hacks" --platform xiaohongshu --format srt --output subtitles.srt
# 7. Batch generation
scriptforge batch --topics-file topics.txt --output-dir ./scripts --platform tiktok
# 8. Initialize a project
scriptforge init my-video-projectCreate a config file scriptforge.yaml:
# Use OpenAI
provider:
name: openai
api_key: sk-your-key-here
model: gpt-4o-mini
# Use Anthropic Claude
# provider:
# name: anthropic
# api_key: sk-ant-your-key-here
# model: claude-sonnet-4-20250514
# Use local Ollama (completely free)
# provider:
# name: ollama
# model: llama3
# base_url: http://localhost:11434
# Or use environment variables
# export OPENAI_API_KEY=sk-your-key-here
# export SCRIPTFORGE_PROVIDER=ollama| Template | Platform | Duration | Best For |
|---|---|---|---|
tiktok-15s |
TikTok | 15s | Quick hook videos |
tiktok-30s |
TikTok | 30s | Medium content videos |
tiktok-60s |
TikTok | 60s | In-depth content videos |
youtube-60s |
YouTube Shorts | 60s | Knowledge sharing |
bilibili-60s |
Bilibili | 60s | Deep content |
xiaohongshu-30s |
Xiaohongshu/RED | 30s | Product recommendations |
instagram-30s |
Instagram Reels | 30s | Lifestyle content |
generic-30s |
Generic | 30s | Multi-platform distribution |
๐ Script Quality Scores
hook_strength โโโโโโโโโโ 85% A ๐ฃ Hook attractiveness
structure โโโโโโโโโโ 95% A+ ๐ Structural integrity
engagement โโโโโโโโโโ 75% B ๐ฌ Engagement potential
clarity โโโโโโโโโโ 80% A ๐ Content clarity
platform_fit โโโโโโโโโโ 90% A+ ๐ฑ Platform fit
cta_effectiveness โโโโโโโโโโ 70% B ๐ข CTA effectiveness
hashtag_relevance โโโโโโโโโโ 85% A ๐ท๏ธ Hashtag relevance
overall โโโโโโโโโโ 83% A ๐ Overall score
- Zero-Dependency Core: No third-party libraries for maximum portability
- Configuration-Driven: YAML config + environment variables for flexibility
- Template-Based: Platform templates ensure scripts follow best practices
- Extensible: Clean module architecture for easy additions
- Python 3.9+: Broad compatibility, rich standard library
- urllib: Zero-dependency HTTP requests (no requests library)
- Built-in YAML Parser: No PyYAML dependency
- Built-in Template Engine: No Jinja2 dependency
- ๐ฅ Auto-generate storyboard images (integrate image generation APIs)
- ๐ Script A/B testing comparison
- ๐ Script history management & version diff
- ๐ More language support (French, German, Arabic, etc.)
- ๐ฑ Web UI interface
- ๐ Integration with video editors (FFmpeg, CapCut, etc.)
pip install scriptforgegit clone https://github.com/gitstq/scriptforge.git
cd scriptforge
pip install -e .| Environment | Min Version | Recommended |
|---|---|---|
| Python | 3.9 | 3.11+ |
| OS | Windows/macOS/Linux | Any |
| Ollama (optional) | 0.1.0 | Latest |
Contributions are welcome! Please follow these steps:
- Fork this repository
- Create a feature branch:
git checkout -b feat/your-feature - Write code and tests
- Ensure all tests pass:
python -m unittest discover tests/ - Commit your changes:
git commit -m "feat: add your feature" - Push to the branch:
git push origin feat/your-feature - Submit a Pull Request
See CONTRIBUTING.md for detailed guidelines.
This project is licensed under the MIT License.
Made with โค๏ธ by gitstq