环境准备
在开始之前,先把运行环境准备好。这个项目本质上还是一套本地 Python 应用,环境没配稳,后面再怎么折腾接口也白搭。
你需要准备:
- Python 3.10 或更高版本
- Conda,或者至少有可用的
pip
如果你平时已经装好了 Anaconda 或 Miniconda,后面的步骤会顺手很多,因为它能把项目环境单独隔离出来,避免和系统里其他 Python 包互相打架。
第一次安装:把项目跑起来
如果这是你第一次接触这个项目,照着下面的顺序来就行,不需要理解每一条命令的细节,先把服务启动起来更重要。
拉取项目代码
先打开终端。Windows 用户一般直接用 Anaconda Prompt 更省事,然后把仓库克隆到本地,再切换到项目目录。
git clone https://github.com/yourusername/ai-novel-generator-4.0.git
cd ai-novel-generator-4.0
这里要注意,git clone 和 cd 最好分两行写。很多新手喜欢把它们连在一起复制,虽然有时也能跑,但出问题时不容易排查。
创建独立环境
接下来创建一个专属的 Conda 环境,Python 版本建议固定在 3.10。这样做的好处很直接:依赖冲突少,后续维护也省心。
conda create -n ai-novel-generator python=3.10
conda activate ai-novel-generator
激活成功后,命令行前面通常会多出环境名,比如 (ai-novel-generator)。看到这个提示,说明你已经进入正确的'房间'了。
安装依赖
项目依赖统一写在 requirements.txt 里,直接安装即可:
pip install -r requirements.txt
这一步一般会持续一会儿,尤其是网络不太稳定的时候,耐心等它跑完。只要没有报错,后面就顺很多。
启动服务
依赖装好后,启动项目:
python run.py
如果一切正常,终端会提示本地服务地址。通常打开浏览器访问 http://127.0.0.1:7860,就能看到界面了。
关机后怎么重新启动
很多人第一次能跑通,第二天再打开就卡住,原因其实很简单:你不需要重装,只要重新进入项目目录并激活环境就行。
假设你的项目放在 Windows 用户目录下,重新开启时可以按这个思路来:
cd C:\Users\LING\ai-novel-generator-4.5
conda activate ai-novel
python run.py
这里有两个地方值得留意:
- 路径要换成你自己的实际路径
- 环境名也要和你创建时保持一致
只要命令行前面出现了对应的环境名,再执行 python run.py,服务就会重新起来。
配置 API 接口
界面出来以后,工具还不能直接工作,因为它还缺一个'大脑'——也就是大模型接口。
这类本地写作工具的核心思路都差不多:前端负责输入和展示,真正的生成能力交给外部模型服务。你只需要把 API Key、接口地址和模型名称填对,后面就能正常调用。
获取 API Key
先去对应平台创建 API 密钥。拿到的这串 Key,本质上就是程序调用模型时的身份凭证,配置错了或者填漏了,接口就没法正常返回结果。


