快速开始
5 分钟在本地跑起 ollmo 全栈。
前置条件
1. 克隆与配置
git clone https://github.com/ollmo-go/ollmo.git
cd ollmo
cp .env.example .env
2. 启动基础设施
make up
启动 MySQL、Redis、MinIO、Milvus 和 Asynqmon 面板:
| 服务 | 地址 | 凭据 |
|---|---|---|
| MySQL | localhost:3306 | ollmo / ollmo_dev_pwd |
| MinIO Console | http://localhost:9001 | minioadmin / minioadmin |
| Milvus | localhost:19530 | — |
| Asynqmon UI | http://localhost:8081 | — |
3. 数据库迁移
make migrate
4. 启动后端(API + Worker)
# 终端 1:API 服务
make server
# 终端 2:Asynq Worker(文档解析与向量化)
make worker
5. 启动前端
make web # http://localhost:3001
6. 一键安装向导
打开 http://localhost:3001 —— 首次访问会自动进入安装向导(仅当系统尚未初始化时出现):
填写管理员邮箱与密码;展开「可选配置」后可以填写 SiliconFlow API Key(跳过则稍后在设置中添加):
确认后系统会自动:
- 创建管理员团队与超级管理员用户;
- 预置 SiliconFlow 供应商,包含 LLM(DeepSeek-V4-Flash)、Embedding(BGE-Large-ZH)、Rerank(BGE-Reranker-V2-M3)模型;
- 创建演示知识库,内置标准模板 Agent 画布(意图分类 → 检索 → 条件分支 → LLM / 直接回复 + 闲聊分支);
- 上传演示文档并自动完成解析、切片与向量化。
安装完成后,直接在首页输入问题即可体验完整问答流程,无需手动配置。
:::caution 安装后默认关闭注册 安装完成后系统默认关闭注册。需要邀请成员时,在「系统设置」中开启,或通过邀请链接加入团队。 :::
一键 Docker 全栈
跳过 2–5 步,直接构建并启动全部服务(基础设施 + server + worker + web):
make up-full
首次提问
进入首页对话,选择「演示知识库」,试试问(演示文档为《产品介绍》,这些问题都能从中找到答案):
- ollmo 支持哪些文档格式?
- 如何接入自己的模型?
- ollmo 的核心能力有哪些?
回答会标注来源文档,点击引用即可在右侧打开源文档并高亮原文段落——PDF 原版与解析视图可切换,对话与文档并排对照:
:::tip 自动记忆 对话满 10 条消息后,ollmo 会自动在后台生成会话摘要;之后新建对话会自动注入这些摘要,实现跨对话上下文延续。可在「系统设置」中关闭。 :::