跳到主要内容

安装

Memorose 通常由 Rust 服务端和独立的 dashboard UI 组成。

前置要求​

  • Rust 工具链
  • 一个用于整合和向量嵌入的 LLM Provider Key
  • 可选：jq，便于执行文档里的命令行示例

克隆仓库​

git clone https://github.com/ai-akashic/Memorose.git
cd Memorose

环境配置​

先复制环境变量模板并填写 Provider 配置。

cp .env.example .env

最少需要配置：

LLM_PROVIDER=gemini
GOOGLE_API_KEY=your_google_api_key_here
LLM_MODEL=gemini-3.1-flash-lite-preview
EMBEDDING_MODEL=gemini-embedding-2-preview

如果你不想继续使用默认 dashboard 密码，也可以顺手加上：

DASHBOARD_ADMIN_PASSWORD=change-me

配置文件​

从官方示例开始：

cp config.example.toml config.toml

当前配置结构包括：

  • [server]
  • [database]
  • [consolidation]
  • [forgetting]
  • [graph]
  • [raft]
  • [cache]
  • [multimodal]
  • [security]
  • [telemetry]
  • [development]

启动整套服务​

推荐本地启动方式：

./scripts/start_cluster.sh start --clean --build

这会启动后端节点和 dashboard UI。

只启动 API 服务​

cargo run --release -p memorose-server

验证安装​

curl http://127.0.0.1:3000/

预期响应：

Memorose is running.

Dashboard​

  • Dashboard UI：http://127.0.0.1:3100/dashboard
  • API 重定向入口：http://127.0.0.1:3000/dashboard
  • 默认登录：admin / admin

首次使用后应立即修改密码，或者在启动前设置 DASHBOARD_ADMIN_PASSWORD。

注意 (Docker 部署 Dashboard)： 如果你自己编写 docker-compose.yml 或使用 docker run 部署 Dashboard，你必须为 Dashboard 容器设置 DASHBOARD_API_ORIGIN 环境变量（例如 DASHBOARD_API_ORIGIN=http://memorose:3000），让它知道如何将 API 请求路由给后端。否则，你在登录时会遇到 connect ECONNREFUSED 127.0.0.1:3000 报错。