> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurogen.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

安装有三种方法

### **1. 一键安装包（推荐）**

前往 [<u>Releases</u>](https://github.com/UniRound-Tec/Aurogen/releases) 下载对应平台的整合包，内置 Python 和 Node.js 运行时，无需安装任何额外软件。

| **平台**  | **架构**                      | **文件**                             |
| :------ | :-------------------------- | :--------------------------------- |
| macOS   | Apple Silicon (M1/M2/M3/M4) | `aurogen-x.x.x-macos-arm64.tar.gz` |
| Linux   | ARM64                       | `aurogen-x.x.x-linux-arm64.tar.gz` |
| Linux   | x86\_64                     | `aurogen-x.x.x-linux-x64.tar.gz`   |
| Windows | x64                         | `aurogen-x.x.x-windows-x64.zip`    |

**macOS / Linux：**

```text theme={null}
tar -xzf aurogen-x.x.x-<平台>.tar.gz
cd aurogen-x.x.x-<平台>
bash start.sh
```

**Windows：** 解压后双击 `start.bat`

在浏览器中打开 `http://localhost:8000`，所有配置均在 Web 界面中完成。

### **2. Docker安装**

构建镜像：

```text theme={null}
docker build -t aurogen .
```

运行 Aurogen 并持久化工作区：

```text theme={null}
docker run --rm -p 8000:8000 \
  -v "$(pwd)/aurogen/.workspace:/app/aurogen/.workspace" \
  aurogen
```

然后访问 `http://localhost:8000`。

### **Docker Compose**

在项目根目录直接运行：

```text theme={null}
docker compose up -d --build
```

### **3. 开发部署**

**前置依赖：** [<u>conda</u>](https://docs.conda.io/)（或其他 Python 环境管理器）和 [<u>Node.js</u>](https://nodejs.org/)。

在项目根目录运行：

**1. 启动后端：**

```text theme={null}
# 创建环境
conda create -n aurogen python=3.12

# 安装依赖
conda activate aurogen && cd ./aurogen && pip install -r requirements.txt

# 启动服务
uvicorn app.app:app --host 0.0.0.0 --port 8000 --reload
```

**2. 启动前端：**

```text theme={null}
cd ./aurogen_web && npm i
npm run dev
```