项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5704
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Docker 环境(推荐使用 Docker 部署)
- Python 3.11+(本地运行后端时)
- uv 包管理器(本地安装后端依赖)
- Node.js 与 pnpm(本地安装前端依赖)
- Gemini / Nano Banana Pro 的 API Key(在 Web UI 中配置)
安装与启动步骤
-
1启动 Docker 容器
官方推荐的最简方式,一条命令启动服务;映射 12398 端口并挂载 history、output 目录以持久化数据。
docker run -d -p 12398:12398 -v ./history:/app/history -v ./output:/app/output histonemax/redink:latest -
2或用 docker-compose
可选方式:先从项目仓库下载 docker-compose.yml 文件,再在文件所在目录执行启动命令。
docker-compose up -d -
3访问并配置 API Key
浏览器打开本地地址,进入 Settings 设置页填写 API Key,否则无法调用文案与图像模型。
-
4本地安装后端依赖
不使用 Docker 时,在项目根目录用 uv 同步后端依赖。
uv sync -
5本地安装前端依赖
进入 frontend 目录,用 pnpm 安装前端依赖。
cd frontend pnpm install
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API Key | 是 | 调用 Gemini 文案与 Nano Banana Pro 图像模型的密钥 | sk-xxxxxxxx |
text_providers.yaml | 否 | 可选的自定义文本模型配置,可挂载进容器 | -v ./text_providers.yaml:/app/text_providers.yaml |
/app/history | 否 | 历史记录持久化目录,对应宿主机的 ./history | ./history:/app/history |
/app/output | 否 | 生成图片的持久化目录,对应宿主机的 ./output | ./output:/app/output |
高并发开关 | 否 | 默认最多并发生成 15 页,API 不支持时需在设置中关闭 | 关闭高并发 |
如何确认成功
容器启动后访问 http://localhost:12398,页面正常打开并能进入 Settings 配置页即部署成功。
常见问题
Q:容器里自带 API Key 吗?
A:不包含任何 API Key,镜像中未内置密钥,必须在启动后于 Web UI 的 Settings 页面自行配置。
Q:生成的图片和历史记录会丢失吗?
A:不会。使用 -v ./history:/app/history 和 -v ./output:/app/output 挂载后,历史与图片会保留在宿主机目录。
Q:批量生成报错或失败怎么办?
A:默认并发生成最多 15 页,如果所用 API 不支持高并发,请在设置中关闭高并发选项后重试。
Q:不想用 docker run 怎么办?
A:可下载 docker-compose.yml 后在目录内执行 docker-compose up -d;也可本地用 uv sync 与 pnpm install 安装依赖后自行运行。
注意事项
- 官方推荐使用 Docker 方式部署,一条命令即可启动。
- 务必在 Web UI 的 Settings 页配置 API Key,否则无法生成文案与图片。
- 建议挂载 history 与 output 目录,避免容器重建后数据丢失。
- 本地源码运行的部分步骤(如克隆仓库、启动服务)README 节选中未完整给出,请对照仓库 README 补齐。
核心亮点
- 深度集成 Nano Banana Pro,图文生成质量高且风格统一
- 提供 Docker 一键部署,降低本地环境配置门槛
- 前后端分离架构,便于二次开发和功能扩展
不足之处
- 依赖外部 AI 服务(如 Gemini),可能产生 API 费用
- 文档/社区待观察
适用场景
- 小红书博主快速产出图文笔记
- 品牌方批量生成种草内容
- 个人创作者自动化内容流水线
替代项目
Dify、FastGPT、LangChain
同类项目推荐
book-genesis-studio
开源
让 AI 代理按流程帮你写完一本书并导出 EPUB
Open-source writing skills for Claude Code, Codex, OpenCode, Antigravity, Gemini, Op···
ecrivai
开源
输入关键词,自动选题写博客,告别灵感枯竭。
Fully automated AI blog writer that uses LangChain and GPT type LLMs for topic selec···
siming-ai
开源
本地小说创作工作台,设定与草稿一处管,AI 辅助续写
Local novel writing AI workspace with packaged Windows launcher.
awesome-deliberative-prompting
开源
学会精准提问,让AI推理更可靠、决策更理性。
Awesome deliberative prompting: How to ask LLMs to produce reliable reasoning and ma···
chinese-novelist-skill
开源
用AI一口气写出10-50章不崩人设不烂尾的中文长篇小说
AI 写小说:从零生成 10-50 章完整中文小说,三层问答 · 创作记忆 · 悬念钩子 · 自动校···
humanizer_academic
开源
一键去除论文AI味,让医学写作更像真人
A Claude Code skill that removes signs of AI-generated writing from academic medical···
qijing-ai-guide
开源
套模板让 AI 写出像样的中文同人文
奇境 AI 中文同人小说创作指南、创作模板与教学示例 | Chinese fanfiction writing guides···
ResearchStudio
开源
从研究想法到论文发表,AI 全程帮你搞定!
ResearchStudio: Our AI co-author, from research problem to final publication.
humanize-text
开源
AI初稿过一遍,读起来像人写的
Open-source AI humanizer: rewrite AI-generated text into natural, human-sounding pro···
