一、安装必要软件
在开始之前，请确保以下软件已正确安装：
1. Node.js（可选，用于前端开发）
- 下载地址：https://nodejs.org/zh-cn/download
- 建议安装 LTS 版本。
2. Git（用于克隆项目）
- 下载地址：https://git-scm.com/install/windows
- Windows 用户选择对应安装包，Linux/macOS 可使用包管理器安装。
3. Python（≥ 3.11）
- 下载地址：https://www.python.org/downloads/
- 安装时请勾选 "Add Python to PATH"（Windows）。
三、环境要求确认
- Python：3.11 或更高版本
- Node.js：14+（可选，仅前端开发需要）
- 操作系统：Windows / macOS / Linux
五、启动后端服务并加载模型
为了加速模型下载，建议配置国内镜像（以 Hugging Face 为例）：
bash
# Windows PowerShell 中设置环境变量
$env:HF_ENDPOINT = "https://hf-mirror.com"
# Linux / macOS 中使用 export
export HF_ENDPOINT=https://hf-mirror.com然后进入 backend 目录，激活虚拟环境，启动后端：
bash
cd backend # 如果已在 kronos-ai 目录下
.venv\Scripts\activate # Windows
# 或 source .venv/bin/activate # Linux/macOS
python main.py启动成功后，后端服务将开始运行（通常监听 http://localhost:8000 或类似地址）。
七、常见问题
- 模型下载慢 ：请确保已设置
HF_ENDPOINT为国内镜像。 - Python 版本不对 ：使用
python --version检查，建议使用 3.11+。 - 端口冲突 ：可修改
python -m http.server 3000中的端口号，如8080。 - Windows 路径错误 ：所有
\在命令中应使用反斜杠，但在 Git Bash 或 WSL 中请使用/。