CofmyUI本地部署教程

一、环境准备

1.1 系统要求

• Python 3.10 或更高版本
• Node.js 16+（用于前端构建）
• Git
• 至少4GB内存，推荐8GB+

1.2 安装Python和Node.js

# 检查Python版本
python --version   # 需要 3.10+

# 检查Node.js版本
node -v            # 需要 16+

# Windows用户可从官网下载安装包

二、安装步骤

2.1 克隆项目

git clone https://github.com/cofmy/cofmyui.git
cd cofmyui

2.2 安装后端依赖

# 创建虚拟环境（推荐）
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

2.3 安装前端依赖

cd frontend
npm install
npm run build
cd ..

三、配置模型接入

3.1 配置文件说明

复制并编辑配置文件：

cp config.example.yaml config.yaml

3.2 接入OpenAI

# config.yaml
models:
  - name: "GPT-4o"
    provider: "openai"
    api_key: "sk-your-openai-key"
    model: "gpt-4o"
    base_url: "https://api.openai.com/v1"

3.3 接入Claude

  - name: "Claude Sonnet"
    provider: "anthropic"
    api_key: "sk-ant-your-key"
    model: "claude-sonnet-4-20250514"

3.4 接入本地Ollama

  - name: "Qwen2.5"
    provider: "ollama"
    model: "qwen2.5:7b"
    base_url: "http://localhost:11434"

四、启动服务

# 启动后端服务
python main.py

# 服务默认运行在 http://localhost:8000
# 打开浏览器访问即可使用