OpenFic

环境要求

• 已安装 Docker（推荐自托管方式）
• 或已具备 Python 环境与 pip（用于 pip 安装方式）
• 本机 8000 端口可用
• 准备一个兼容 OpenAI API 的模型服务 API Key

安装与启动步骤

1. 1Docker 一键启动

   README 推荐用容器自托管，把 8000 端口映射出来，并用名为 openfic 的数据卷持久化项目数据。

   docker run -d -p 8000:8000 -v "openfic:/data" --name openfic ghcr.io/syrizelink/openfic:latest

   复制

2. 2或 pip 安装

   不想用 Docker 时，可用 pip 安装 OpenFic 包；README 未给出版本要求，建议在独立虚拟环境中执行。

   pip install openfic

   复制

3. 3启动服务

   pip 安装方式需手动启动后端服务，命令为 openfic serve；保持终端窗口运行不要关闭。

   openfic serve

   复制

4. 4打开写作界面

   服务监听 8000 端口，浏览器访问本机地址即可进入 OpenFic 工作台开始创建项目。

如何确认成功

浏览器打开 http://localhost:8000，能看到 OpenFic 界面即启动成功；Docker 可用 docker ps 查看 openfic 容器运行中。

常见问题

注意事项

• README 未给出 Python 版本要求，pip 安装方式如遇问题建议改用 Docker。
• OpenFic 更适合作者主动维护世界观、角色和章节结构，不适合一次性通用文案生成。
• 使用云端模型服务时需自行准备 API Key，本地持久化只针对项目数据。
• README 提到存在桌面版，但未给出具体安装命令，本教程未包含。