Skip to content

ak15963/ai-creative-forge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦞 AI Creative Forge

AI 创意内容生成工具 — 表情包文案 · 同人小说 · 短视频脚本,一站式生成

Python License Tests OpenAI Compatible

AI Creative Forge 是一个受 OpenClaw 龙虾 AI 创意社区启发而生的开源 Python 工具,专注于三大创意内容场景的 AI 自动化生成:

功能模块 描述 支持风格/类型
🎭 表情包生成器 根据主题自动生成表情包文案 Doge、Drake、分心男友、脑容量扩展、通用
📖 同人小说生成器 指定 IP 和角色生成完整同人故事 校园、甜宠、虐恋、搞笑、悬疑、奇幻、现代都市
🎬 短视频脚本生成器 生成带分镜的专业短视频脚本 抖音、B站、小红书、YouTube、Instagram

目录


功能特性

🎭 表情包文案生成器

基于经典互联网表情包模板,结合 LLM 的创意能力,生成贴近中文网络文化的表情包文案:

  • 6 种模板风格:Doge 狗狗体、Drake 点赞拒绝、分心男友三格、脑容量扩展四级、通用梗图、AI 自定义
  • 批量生成:单次最多生成 10 条,每条包含正文、梗点说明、话题标签和 emoji 建议
  • 双语支持:支持中文和英文输出
  • 自动保存:结果以 JSON 格式保存至 outputs/ 目录

📖 同人小说生成器

针对各类 IP(动漫、游戏、影视、小说)生成结构完整的同人故事:

  • 7 种故事类型:校园、甜宠、虐恋、搞笑、悬疑、奇幻、现代都市
  • 3 种篇幅:短篇(600-1000字)、中篇(1500-2500字)、长篇(3000-4500字)
  • 完整结构:自动生成标题、简介、章节正文、话题标签、作者后记
  • 视角选择:支持第一人称和第三人称叙事
  • Markdown 输出:保存为标准 Markdown 格式,可直接发布至 Lofter、晋江等平台

🎬 短视频脚本生成器

生成专业级分镜脚本,覆盖主流短视频平台:

  • 5 大平台适配:抖音、B站、小红书、YouTube、Instagram,针对各平台特性优化
  • 5 种视频风格:干货知识型、娱乐搞笑型、情感共鸣型、教程实操型、Vlog 生活记录型
  • 完整脚本要素:开场钩子、逐镜头场景描述、旁白台词、视觉特效建议、BGM 推荐、发布文案、话题标签、CTA
  • 时长精准控制:按中文语速(3.5字/秒)精确计算旁白字数

快速开始

环境要求

  • Python 3.8 或以上版本
  • 有效的 OpenAI API Key(或兼容 OpenAI 格式的其他 LLM API)

安装步骤

第一步:克隆仓库

git clone https://github.com/ak15963/ai-creative-forge.git
cd ai-creative-forge

第二步:安装依赖

pip install -r requirements.txt

第三步:配置 API Key

cp .env.example .env
# 编辑 .env 文件,填入你的 API Key

.env 文件内容示例:

OPENAI_API_KEY=sk-your-api-key-here
# 如使用 DeepSeek:
# OPENAI_BASE_URL=https://api.deepseek.com/v1
# AI_MODEL=deepseek-chat

第四步:运行

# 进入交互式菜单(推荐新手)
python main.py interactive

# 或直接使用命令行
python main.py meme --topic "周一综合症" --style drake

详细使用说明

表情包生成器

python main.py meme --topic <主题> [选项]
参数 说明 默认值 可选值
--topic 表情包主题/梗点(必填) 任意文本
--style 模板风格 general doge / drake / distracted / expanding_brain / general / custom
--count 生成数量 3 1-10
--lang 输出语言 zh zh / en

使用示例:

# 生成 3 条 Drake 风格表情包
python main.py meme --topic "周一综合症" --style drake --count 3

# 生成 5 条脑容量扩展风格(英文)
python main.py meme --topic "how to deal with bugs" --style expanding_brain --count 5 --lang en

# 生成通用梗图
python main.py meme --topic "打工人的一天" --style general

Python API 调用:

from src.utils.config import Config
from src.meme_generator.generator import MemeGenerator

config = Config()
gen = MemeGenerator(config)

result = gen.generate(
    topic="周一综合症",
    style="drake",
    count=3,
)
gen.display_results(result)

同人小说生成器

python main.py fanfic --fandom <IP名称> --characters <角色> [选项]
参数 说明 默认值 可选值
--fandom IP/作品名称(必填) 如:原神、哈利波特
--characters 角色名,逗号分隔(必填) 如:刻晴,旅行者
--genre 故事类型 校园 校园 / 甜宠 / 虐恋 / 搞笑 / 悬疑 / 奇幻 / 现代都市
--length 篇幅 short short / medium / long
--pov 叙事视角 third first / third

使用示例:

# 原神甜宠短篇
python main.py fanfic --fandom "原神" --characters "刻晴,旅行者" --genre 甜宠

# 哈利波特搞笑中篇(第一人称)
python main.py fanfic --fandom "哈利波特" --characters "哈利,赫敏,罗恩" --genre 搞笑 --length medium --pov first

# 现代都市虐恋长篇
python main.py fanfic --fandom "某某偶像剧" --characters "男主,女主" --genre 虐恋 --length long

Python API 调用:

from src.utils.config import Config
from src.fanfiction_writer.writer import FanfictionWriter

config = Config()
writer = FanfictionWriter(config)

result = writer.write(
    fandom="原神",
    characters=["刻晴", "旅行者"],
    genre="甜宠",
    length="short",
)
writer.display_result(result)

短视频脚本生成器

python main.py script --topic <主题> [选项]
参数 说明 默认值 可选值
--topic 视频主题(必填) 任意文本
--platform 目标平台 douyin douyin / bilibili / xiaohongshu / youtube / instagram
--duration 视频时长(秒) 60 15-600
--style 视频风格 informative informative / entertaining / emotional / tutorial / vlog
--hook 自定义开场钩子 自动生成 任意文本

使用示例:

# 抖音60秒干货视频
python main.py script --topic "AI改变生活" --platform douyin --duration 60

# B站搞笑视频,自定义开场
python main.py script --topic "程序员日常" --platform bilibili --duration 90 --style entertaining \
  --hook "你以为程序员每天都在敲代码?错了!"

# 小红书30秒教程
python main.py script --topic "用AI生成表情包" --platform xiaohongshu --duration 30 --style tutorial

Python API 调用:

from src.utils.config import Config
from src.video_script_gen.generator import VideoScriptGenerator

config = Config()
gen = VideoScriptGenerator(config)

result = gen.generate(
    topic="AI改变生活",
    platform="douyin",
    duration=60,
    style="informative",
)
gen.display_result(result)

项目结构

ai-creative-forge/
├── main.py                          # 主入口,CLI 命令解析
├── requirements.txt                 # Python 依赖
├── setup.py                         # 安装配置
├── .env.example                     # 环境变量配置模板
├── .gitignore
│
├── src/                             # 核心源码
│   ├── __init__.py
│   ├── meme_generator/              # 表情包生成器
│   │   ├── __init__.py
│   │   └── generator.py             # 核心生成逻辑 + 6种模板
│   ├── fanfiction_writer/           # 同人小说生成器
│   │   ├── __init__.py
│   │   └── writer.py                # 核心写作逻辑 + 7种类型
│   ├── video_script_gen/            # 短视频脚本生成器
│   │   ├── __init__.py
│   │   └── generator.py             # 核心生成逻辑 + 5平台适配
│   └── utils/                       # 公共工具模块
│       ├── __init__.py
│       ├── config.py                # 配置管理(API Key、参数)
│       ├── llm_client.py            # LLM 客户端封装(重试、JSON模式)
│       ├── logger.py                # 统一日志模块
│       └── interactive.py           # 交互式菜单
│
├── tests/                           # 单元测试
│   ├── __init__.py
│   └── test_generators.py           # 12个测试用例(全部通过)
│
├── examples/                        # 使用示例
│   ├── example_meme.py
│   ├── example_fanfic.py
│   └── example_script.py
│
├── assets/
│   └── templates/                   # 可扩展的提示词模板
│
├── docs/                            # 文档目录
│
└── outputs/                         # 生成内容输出目录(自动创建)

支持的 AI 模型

本项目使用 OpenAI 兼容 API 格式,支持以下模型(在 .env 中配置):

模型提供商 模型名称 Base URL 特点
OpenAI gpt-4o-mini(推荐) https://api.openai.com/v1 性价比高,速度快
OpenAI gpt-4o https://api.openai.com/v1 质量最高
DeepSeek deepseek-chat https://api.deepseek.com/v1 中文能力强,价格低
阿里云百炼 qwen-plus https://dashscope.aliyuncs.com/compatible-mode/v1 国内访问稳定
Moonshot moonshot-v1-8k https://api.moonshot.cn/v1 长文本支持好

OpenClaw 创意玩法背景

本项目灵感来源于 OpenClaw(龙虾 AI) 社区的热门创意玩法。OpenClaw 是一个开源的个人 AI 助手框架(188K+ GitHub Stars),其社区涌现出大量创意项目:

OpenClaw 热门创意项目玩法概览:

玩法类型 描述 难度
内容创作自动化 自动生成表情包、同人故事、短视频脚本 ⭐⭐
每日 Reddit 摘要 自动抓取并过滤感兴趣的帖子,发送到 Telegram
个人知识库 RAG 发送 URL 自动入库,自然语言检索 ⭐⭐
隔夜 Mini-App 构建 睡前描述目标,早起收到可运行的小应用 ⭐⭐⭐
个人 CRM 系统 自动扫描邮件/日历,维护联系人关系 ⭐⭐⭐
多智能体协作团队 多个 Agent 分工协作,各司其职 ⭐⭐⭐⭐
自愈家庭服务器 AI 自动监控并修复服务器问题 ⭐⭐⭐⭐
病毒式 AI 动画视频 用 AI 生成爆款动画短视频 ⭐⭐⭐

AI Creative Forge 专注于其中最具趣味性的「创意内容生成」方向,将其封装为开箱即用的 Python 工具。


运行测试

# 运行所有测试
python -m pytest tests/ -v

# 运行特定测试类
python -m pytest tests/test_generators.py::TestMemeGenerator -v

# 查看测试覆盖率
pip install pytest-cov
python -m pytest tests/ --cov=src --cov-report=html

贡献指南

欢迎提交 Issue 和 Pull Request!

如何贡献:

  1. Fork 本仓库
  2. 创建功能分支:git checkout -b feature/your-feature-name
  3. 提交更改:git commit -m 'feat: add your feature'
  4. 推送分支:git push origin feature/your-feature-name
  5. 提交 Pull Request

可以贡献的方向:

  • 新增表情包模板(如 "两个按钮"、"蜘蛛侠互指" 等)
  • 新增同人小说故事类型
  • 新增短视频平台适配(如快手、TikTok)
  • 添加图片生成功能(调用 DALL-E 或 Stable Diffusion 生成配图)
  • 添加 Web UI 界面
  • 多语言支持(日文、韩文等)

许可证

本项目采用 MIT License 开源协议。


Star History

如果这个项目对你有帮助,请给个 ⭐ Star 支持一下!


由 AI Creative Forge 团队用 ❤️ 构建,灵感来自 OpenClaw 龙虾 AI 创意社区

About

🦞 AI 创意内容生成工具 - 表情包文案 / 同人小说 / 短视频脚本,一站式 AI 生成器 | Inspired by OpenClaw

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages