ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

ai-memory Docker安装教程:3步搭建AI记忆库完整指南

ai-memory Docker安装教程:3步搭建AI记忆库完整指南 ai-memory Docker安装教程3步搭建AI记忆库完整指南【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memoryai-memory 是一个为 AI 编程 CLI 提供长期记忆long term memory的开源项目解决 LLM 编码代理会话结束即失忆、以及不同厂商 Agent 之间无法交接上下文handoff的痛点。本文将带你用 Docker 完成 ai-memory 记忆库的 3 步部署拉取代码、启动容器、接入你的 AI 编程工具。全程不到 10 分钟零基础也能照着完成。部署前准备1 个前提条件你只需要满足一个条件机器上已安装Docker含 Docker Compose v2现代发行版默认自带可选但推荐配置 LLM API Key如 Anthropic、OpenAI这样记忆库能自动把会话观察整合成结构化摘要没有 Key 也能运行会退化为纯 FTS5 全文检索 规则化摘要模式。构建镜像采用多阶段编译官方提供了现成的 docker/Dockerfile构建阶段用rust:1.95-slim编译出二进制运行阶段基于debian:bookworm-slim并以非 root 用户运行镜像同时提供linux/amd64与linux/arm64两种架构Apple Silicon 和 ARM 服务器都能原生运行。第 1 步获取代码并构建 Docker 镜像克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/ai/ai-memory cd ai-memory然后使用仓库自带的 Compose 文件一键构建并启动该文件位于 docker/docker-compose.ymlcd docker docker compose up -d --buildCompose 文件做了两件关键的事数据持久化把容器内/data挂载到命名卷ai-memory-data重启不丢记忆健康检查每 30 秒调用ai-memory status自检保证服务挂掉能被发现。 如果不想本地编译也可以直接docker run akitaonrails/ai-memory:latest拉取官方镜像。第 2 步启动容器并验证服务上一条命令已把服务跑起来了。默认只绑定回环地址127.0.0.1:49374确保本机以外的网络无法访问安全又省心。验证方法# 查看容器状态应为 Up (healthy) docker ps # 检查健康状态 docker inspect --format{{.State.Health.Status}} ai-memory # 访问 MCP 端点返回 JSON-RPC 响应即为成功 curl http://localhost:49374/mcp启动后打开浏览器访问http://localhost:49374还能看到内置的 Web 管理界面所有项目和记忆页面一目了然第 3 步把 AI 编程工具接入记忆库容器跑起来后两条命令即可把 AI 编程 CLI如 Claude Code接入 ai-memoryai-memory install-mcp --client claude-code --apply # 接入 MCP 记忆查询工具 ai-memory install-hooks --agent claude-code --apply # 安装生命周期钩子MCP 接入让 Agent 在会话中自动调用memory_query、memory_explore等工具检索记忆钩子接入在session-start、stop、post-tool-use等生命周期节点自动采集脱敏后的观察数据hooks 脚本位于 hooks/ 目录。接入后效果是本次会话的每个提示词和工具调用都会沉淀进记忆库下次在项目目录打开会话哪怕是换一款 Agent比如从 Claude Code 切到 Codex新 Agent 会先收到一份你上次做到哪了的交接简报。生产部署家庭实验室 / 多用户进阶配置本机跑通后若要部署到家庭服务器供多台电脑共享仓库提供了完整的模板文件文件作用docker/docker-compose.prod.yml.example生产 Compose 模板绑定0.0.0.0:49374供局域网访问docker/.env.production.exampleLLM / Embedding / 鉴权 Token 配置模板docs/deploy.md完整部署手册首次部署、密钥更新、备份、回滚、排障两个安全要点官方文档强烈建议启用 Bearer Token 鉴权一旦服务绑定到局域网务必生成 Tokenai-memory generate-auth-token否则同一网络内任何人都能调用可破坏性操作的 MCP 工具叠加 TLS 反向代理局域网明文 HTTP 下 Token 可能被嗅探仓库附带了 Caddy 自动证书与 Cloudflare Tunnel 两套模板docker/compose.tls.caddy.yml、docker/compose.tls.cloudflared.yml详细讲解见 docs/https-via-proxy.md。记忆数据存放在挂载卷中结构为wiki/纯 Markdown可 Git 管理、raw/会话归档、db/SQLite 全文检索 向量嵌入。备份只需 rsync 该目录或用ai-memory backup做一致性快照。常见问题速查Qcurl 返回 Connection refused容器未启动或端口绑定到了127.0.0.1。先docker ps确认容器状态再看 Compose 端口映射。Q健康检查一直 unhealthy多为数据目录权限问题——容器以 uid 1000 运行在宿主机执行sudo chown -R 1000:1000 数据目录即可。Q日志在哪里看docker logs -f ai-memory实时跟踪或浏览数据卷中logs/下的每日滚动日志。Q换了 Embedding 模型后搜索变差启动日志会提示嵌入指纹不匹配执行ai-memory embed --force重建向量即可。完整的安装分支curl 安装、源码编译、无 Docker 方案都收录在 docs/install.md 中。总结回顾一下本次 ai-memory Docker 安装的核心三步克隆代码并docker compose up -d --build构建启动容器验证服务健康检查 MCP 端点 Web 界面三重确认接入 Agentinstall-mcpinstall-hooks两条命令完成闭环。部署完成后你的 AI 编程工具就拥有了跨会话、跨厂商的持久记忆。在 Web 首页中所有工作区与项目按记忆页数和最近活跃时间展示方便你随时审计 Agent 沉淀了哪些知识【免费下载链接】ai-memorySolution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors项目地址: https://gitcode.com/GitHub_Trending/ai/ai-memory创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表