在开始之前，请确保你的系统上已经安装了 Python
快速开始
pip
直接使用 pip 进行安装可能会对系统的全局 Python 环境造成污染，如果你不希望影响现有环境，请考虑使用 uv、Conda或Venv
uv
Conda
1
安装 Anaconda 或 Miniconda
前往 Getting Started 按照指引安装 Anaconda 或 Miniconda。
2
创建 Conda 虚拟环境
3
激活环境
4
安装 OpenFic
5
启动服务器
6
打开 OpenFic
等待启动完成后，在浏览器中打开 http://localhost:8000。
Venv
venv 是 Python 内置的虚拟环境工具
1
创建虚拟环境
2
激活虚拟环境
Linux/macOS：Windows：
3
安装 OpenFic
4
启动服务器
5
打开 OpenFic
等待启动完成后，在浏览器中打开 http://localhost:8000。
常用配置
自定义端口
如果主机的8000 端口已经被占用，可以使用 --port 指定其他端口：
指定数据目录
OpenFic 默认会将数据写入~/.openfic，你可以通过环境变量 OPENFIC_DATA_DIR 指定其他目录：
Linux/macOS：
uvx，请在启动命令前设置：
更新
pip、Conda 和 Venv
激活对应的虚拟环境后执行：uv
使用@latest 运行时，重新执行启动命令即可获取最新版本：
卸载
pip 或 Venv
在对应环境中执行：.venv 文件夹。