Jaaz AI智能体详细安装教程：Windows/macOS本地部署指南

Linzici

下面我为你整理了一份详细的 Jaaz AI 本地部署指南，涵盖了从环境准备到实际使用的完整步骤，无论你使用 Windows 还是 macOS，都可以参照此流程进行操作。

### 🛠️ 安装前准备工作

在开始安装 Jaaz 之前，你需要先配置好它的两大核心依赖：**大语言模型**和**图像生成模型**。

| 核心组件 | 可选方案 | 特点/备注 |
| :--- | :--- | :--- |
| **大语言模型 (LLM)** | **Ollama (本地，推荐)** | 免费、离线运行、保护隐私。支持多种开源模型。 |
| | **OpenAI/Claude 等 (API)** | 需要付费，响应质量和速度可能更佳，但需处理网络和支付问题。 |
| **图像生成模型** | **Wavespeed.ai (API，推荐)** | 价格实惠，新注册用户会赠送体验金。 |
| | **Replicate (API)** | 另一个可选平台，可能需要绑定支付方式。 |

### 💻 第一步：配置大语言模型 (LLM)

这里强烈推荐使用 **Ollama** 在本地部署，因为它完全免费且过程简单。

1.  **下载安装 Ollama**
    *   访问 **Ollama 官网** (`ollama.com`)，下载并安装适用于你操作系统的版本。
    *   安装完成后，Ollama 服务会自动在 `http://localhost:11434` 启动。

2.  **拉取并运行模型**
    *   打开终端（或命令行），输入以下命令来拉取并运行一个开源模型，例如 `qwen2:7b`：
        ```bash
        ollama run qwen2:7b
        ```
    *   等待命令执行完成，模型就准备就绪了。

### 🎨 第二步：配置图像生成模型

对于大多数用户，使用 **Wavespeed.ai** 的 API 是一个不错的起点。

1.  **注册并获取 API Key**
    *   访问 **Wavespeed.ai** 官网，使用 GitHub 或 Google 账号登录。
    *   注册后，平台通常会赠送体验金。
    *   在账户的 **"Access Keys"** 菜单中，复制你的 **API Key**。

### 📥 第三步：安装与启动 Jaaz

Jaaz 提供了图形化界面，安装相对简单。

1.  **获取 Jaaz 安装包**
    *   访问 **Jaaz 的 GitHub 仓库** (`github.com/11cafe/localart`)，在 **"Releases"** 页面找到并下载最新版本的安装包（通常为 `.dmg` 文件用于 macOS，或 `.exe` 文件用于 Windows）。

2.  **安装与首次启动**
    *   **macOS**：将下载的 `.dmg` 文件拖拽到"应用程序"文件夹即可。
    *   **Windows**：直接运行下载的 `.exe` 安装程序。
    *   首次启动 Jaaz 后，你需要进入软件的**设置**（通常为右上角的齿轮图标）。

3.  **关键配置**
    *   **配置 Ollama**：在 LLM 设置部分，确保 API URL 指向 `http://localhost:11434`。Jaaz 应该能自动检测到已通过 Ollama 加载的模型。
    *   **配置 Wavespeed.ai**：在图像模型设置部分，找到 WavespeedAI 的配置项。
        *   **API URL**：填写 `api.wavespeed.ai/api/v3/`。
        *   **API Key**：粘贴你从 Wavespeed.ai 获取的 Key。

### 🚀 第四步：开始使用 Jaaz

完成所有配置后，你就可以开始使用 Jaaz 进行创作了。

1.  在 Jaaz 主界面，分别选择你已经配置好的 **LLM 模型**和**图像生成模型**。
2.  在输入框中描述你的创意，例如"**一只在太空站里看书的猫，科幻风格，细节丰富**"。
3.  设置好图片比例、数量等参数。
4.  点击"**生成**"按钮，Jaaz 便会开始工作，你可以实时查看生成进度。
5.  对生成的图片进行审核与筛选，将满意的作品保存到本地。

### ⚠️ 注意事项与常见问题

*   **API 密钥安全**：务必将你的 API 密钥妥善保存在环境变量或 Jaaz 的设置中，切勿泄露或上传到公开仓库。
*   **费用提醒**：虽然 Ollama 本地运行免费，但使用 Wavespeed.ai 等图像生成 API 会产生费用。请留意平台提供的免费额度及后续的计费标准。
*   **硬件要求**：本地运行大语言模型对电脑硬件有一定要求。如果模型运行缓慢，可以尝试在 Ollama 中换用更小的模型（如 `qwen2:1.5b`）。
*   **技术门槛**：作为开源工具，Jaaz 可能涉及一些技术配置，遇到问题时可以查阅其 GitHub 仓库的文档或社区寻求帮助。

希望这份详细的指南能帮助你顺利踏上 Jaaz AI 的创意之旅！如果在配置 Ollama 或选择模型时遇到任何具体困难，可以随时再来提问。