Skip to content

v0.1.0:统一安装引导、Docker 一体化分发与浏览器首配闭环

Choose a tag to compare

@SparkHello SparkHello released this 08 Aug 04:15
· 41 commits to main since this release

首个公开版本。Memory Platform 是本地优先、可审计、可治理的 AI 长期记忆平台:Memory Gateway 负责长期记忆与知识治理,Model Gateway 负责模型渠道、用途路由、故障切换、归因和费用。

安装

一键脚本(推荐,macOS / Linux,无需 Python/Node,也不用 clone 仓库):

curl -fsSL https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/install.sh | sh

脚本会检查 Docker、下载用户版 Compose、自动避开被占用的端口、等待首启就绪,并打印 GATEWAY_API_KEY、admin key 和客户端接入信息。重复运行即升级到最新镜像,数据保留在卷中。

手工方式(Windows,或想自己控制每一步):

curl -O https://raw.githubusercontent.com/SparkHello/Memory_Platform/main/deploy/docker-compose.user.yml
docker compose -f docker-compose.user.yml up -d
docker compose -f docker-compose.user.yml logs memory-platform   # 查看一次性打印的 GATEWAY_API_KEY 与 admin key

镜像:ghcr.io/sparkhello/memory-platform:v0.1.0(linux/amd64 + linux/arm64)。全部运行数据在 memory-platform-data 卷,升级为 docker compose pull && up -d

一键脚本在 v0.1.0 发布之后加入,安装时从 main 获取,与本版本镜像配合使用没有问题。

源码(macOS/Linux,Python ≥ 3.12 + Node 22):

git clone https://github.com/SparkHello/Memory_Platform.git
cd Memory_Platform
scripts/setup.sh

首次配置

  • 浏览器:打开 http://127.0.0.1:2026/ui/ →「模型与路由」→ 粘贴安装时打印的 admin key →「新建渠道」向导(选预设、填渠道 key、从自动发现的模型列表选择),无需任何 CLI 操作。
  • 命令行:modelgw quickstart(内置 DeepSeek / Kimi 中国区 / 小米 MiMo / 阿里云百炼预设)。
  • AI 辅助:见 docs/ai-install.md,配置契约 docs/ai-quickstart.schema.json

客户端接入

Chatbox / RikkaHub / FLIT 等任意 OpenAI 兼容客户端,填三项即可:http://<地址>:2026/v1 + GATEWAY_API_KEY + 模型名固定 memory-auto。详见 docs/client-setup.md(含常见坑速查表)。MCP 端点 /mcp 用于知识库与模型自助记忆管理。

本版本主要内容

  • scripts/setup.sh 一键安装双服务运行栈;AI 辅助 quickstart(不含密钥的 JSON recipe + stdin 密钥输入)。
  • 单容器 Docker 分发:首启自动接线、密钥一次性打印、/data 卷持久化;GHCR 多架构镜像与 CI smoke test。
  • memgw stack install 自动生成并各打印一次 GATEWAY_API_KEY 与 Model Gateway admin key。
  • Web Console「新建渠道」分步向导;Model Gateway 新增 POST /admin/connectionsPOST /admin/deployments(revision 冲突检测、dry_run、整图校验、原子写入热加载);discovery check 返回可见模型列表。
  • 面向个人用户的 docs/client-setup.md 接入指南。

边界

面向个人、本机或可信家庭网络;不要把默认部署当作公网多租户 SaaS。详见 README 的「配置与安全边界」。