跳到主要内容

快速开始

5 分钟在本地跑起 ollmo 全栈。

前置条件​

  • Docker + Docker Compose
  • Go 1.26+
  • Node.js 20+
  • Make（可选，提供便捷命令）

1. 克隆与配置​

git clone https://github.com/ollmo-go/ollmo.git
cd ollmo
cp .env.example .env

2. 启动基础设施​

make up

启动 MySQL、Redis、MinIO、Milvus 和 Asynqmon 面板：

服务地址凭据
MySQLlocalhost:3306ollmo / ollmo_dev_pwd
MinIO Consolehttp://localhost:9001minioadmin / minioadmin
Milvuslocalhost:19530—
Asynqmon UIhttp://localhost:8081—

3. 数据库迁移​

make migrate

4. 启动后端（API + Worker）​

# 终端 1：API 服务
make server

# 终端 2：Asynq Worker（文档解析与向量化）
make worker

5. 启动前端​

make web          # http://localhost:3001

打开 http://localhost:3001 注册账号即可开始使用。

一键 Docker 全栈​

make up-full      # 构建并启动全部（基础设施 + server + worker + web）

首次使用​

  1. 配置模型 — 设置 → 模型设置，添加对话 / 嵌入 / 重排模型并设为默认
  2. 创建知识库 — 新建知识库（嵌入模型可选，纯对话知识库可不设置）
  3. 上传文档 — 拖拽上传，等待解析与向量化完成
  4. 开始对话 — 在对话页提问，回答带来源引用

:::tip 自动记忆 对话满 10 条消息后，ollmo 会自动在后台生成会话摘要；之后新建对话会自动注入这些摘要，实现跨对话上下文延续。可在「系统设置」中关闭。 :::