环境准备
在开始之前,你的电脑需要安装基础运行环境。
- Python 3.10+:程序运行的语言环境,版本不能太低。
- Conda(推荐)或 pip:用于管理代码库。强烈建议使用 Conda,它能帮你把项目环境隔离起来,避免和其他软件冲突。
第一次安装:给代码安个家
如果你是第一次拿到这个项目,请按顺序操作。
第一步:把项目克隆到本地
打开终端(Windows 用户推荐用 Anaconda Prompt),输入以下命令,将项目代码克隆到本地:
git clone https://github.com/yourusername/ai-novel-generator-4.0.git
cd ai-novel-generator-4.0
*注:这步做完,你就已经进入了项目文件夹。
第二步:创建专属虚拟环境
为了不弄乱电脑里的其他环境,我们要用 Conda 创建一个专属的虚拟空间,名字就叫 ai-novel-generator,指定 Python 版本为 3.10。
conda create -n ai-novel-generator python=3.10
conda activate ai-novel-generator
第三步:安装依赖
这就好比给你的软件安装各种零件,运行以下命令,等待进度条走完即可:
pip install -r requirements.txt
第四步:启动服务
一切就绪,输入最后一行命令:
python run.py
当看到终端不再跳动,出现网址提示时,恭喜你,服务已经跑起来了!
关机重启后:如何再次开启?
这是很多新手最容易卡住的地方:第一次安装好了,电脑关机第二天想用,却发现不知道怎么进去了。其实,你不需要重复上面的安装步骤,只需要简单的三步走。
假设你的项目放在了 C 盘的用户目录下,具体操作如下:
- 切换位置:你得先告诉电脑你的文件在哪。输入
cd命令进入项目目录。
cd C:\Users\<YourUsername>\ai-novel-generator-4.5
*注意:这里的路径要根据你实际存放的位置修改,版本号也要对应(比如你是 4.0 就写 4.0)。
- 激活环境:看一下你的命令行提示符前面有没有
(ai-novel)这几个字?如果没有,说明'房间'没开门,输入:
conda activate ai-novel
- 此时,你的提示符应该变成类似这样的状态:
(ai-novel) C:\Users\<YourUsername>\ai-novel-generator-4.5>
- 运行程序:最后,老规矩,输入启动命令:
python run.py
访问界面:无论你是新安装还是重启,只要程序跑起来,打开浏览器,输入地址 http://127.0.0.1:7860,你就能看到 AI 写作的界面了。
关键一步:配置 API 接口
界面出来了,但此刻它还只是个空壳,我们需要给它接上模型服务。根据文档推荐,我们使用兼容 OpenAI 格式的第三方接口提供商。


