AI导哈

AI记忆引擎

一个本地优先的AI代理记忆引擎，用于存储事实、上下文和对话历史，并通过策略和隐私控制以结构化上下文形式检索。

  • by raghuram369
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 raghuram369/synapse

使用说明

Synapse AI内存（Python-存档）

⚠️ 这个项目已经用TypeScript重写了。看 突触ts 对于活动版本。

此存储库已存档，不再维护。

AI代理的本地第一个内存引擎。将事实、上下文和对话历史存储在一个地方，然后将其作为具有策略+隐私控制的结构化上下文进行检索。

当前版本： 0.13.0

为什么这次发布

最近的工作重点是 入职培训+运行时+集成+政策收据该仓库现在为策略执行决策提供了更清晰的零提示设置路径、显式的运行时模式控制和实用的可审计性。

安装

pip install synapse-ai-memory

可选的一步安装程序仍然可用：

curl -fsSL https://synapse.ai/install.sh | bash

快速启动（推荐）

# interactive quickstart (flow does onboarding + integration probes)
synapse onboard --flow quickstart

# CI/non-interactive default setup
synapse onboard --flow quickstart --non-interactive --json

# advanced flow with explicit defaults
synapse onboard --flow advanced \
  --policy-template private \
  --default-scope private \
  --default-sensitive on \
  --enable-service \
  --service-schedule daily

Python API很简单：

from synapse import Synapse
s = Synapse()
s.remember("I prefer dark mode")
print(s.recall("what theme?"))

岩心流动模型

  • 保险库感知内存：隔离 user_id 启用时。
  • 查看第一条路径 通过收件箱进行敏感/不确定的捕获。
  • 自然语言遗忘 进行有针对性的清理。
  • 范围+敏感控制 保守的违约。
  • 便携式格式 (.brain、检查站、进出口）。
  • 联邦图元 (synapse federate, sync, push, pull)配置后可用。
  • 零LLM索引 用于核心回忆/摄入。

运行时和服务管理

  • synapse up --port <port> 启动设备守护进程（MCP stdio服务器+HTTP JSON-RPC回退）
  • synapse down 阻止它。
  • synapse status 显示运行状态和基本商店统计信息。
  • synapse service install|uninstall|status 管理自动启动(launchd / systemd).

运行时默认值仅为本地值；集成可能仅在使用时添加网络调用。

集成（客户+合同元数据）

synapse install 和 synapse integrations 现在按用例划分：

# quick probe + integration ops
synapse integrations list --db ~/.synapse
synapse integrations list --json

# install / verify / repair / open flows for detected clients
synapse integrations install claude
synapse integrations test cursor
synapse integrations repair windsurf
synapse integrations open continue

synapse integrations list --json 包括连接器合同元数据(type, tier, commands, capabilities, doctor_checks, example_prompt)对于支持的内置组件。

synapse install 仍然可以处理更广泛的安装目标（例如 telegram, ollama, nanoclaw)作为直接安装程序路径。

保单收据（第一阶段）

许可证决策的审计跟踪现在可以从策略挂钩中获得。

synapse permit receipts --last 5
synapse permit receipts --last 5 --json

笔记：

  • 收据写在 <db>/receipts/permit_receipts.jsonl.
  • 架构稳定(synapse.permit.receipt.v1)用于JSON输出。
  • 这是一个 第一阶段实施：它记录了执行决策和原因，但日志量和保留策略故意最小化。

MCP服务器

该项目通过以下方式公开MCP工具：

  • synapse serve （默认设备模式）
  • synapse serve --http --port 8765 （HTTP JSON-RPC）
  • synapse-mcp 包装器（托管启动器位于 ~/.synapse/bin/synapse-mcp)

用途：

synapse serve                 # local stdio-compatible mode
synapse serve --http --port 8765

有关客户端集成，请参阅 synapse install <client> 以及入职文件。

关键CLI命令

# onboarding
synapse onboard --flow quickstart
synapse onboard --flow advanced --non-interactive

# integrations & connectors
synapse integrations list --json
synapse integrations install claude
synapse integrations test claude
synapse integrations repair claude

# policy and runtime
synapse permit receipts --last 10 --json
synapse up --port 8765
synapse down
synapse status
synapse service install

# runtime memory operations (examples)
synapse ingest "User prefers concise responses"
synapse clip "Meeting notes: ..."
synapse watch --clipboard
synapse inbox list
synapse nlforget "forget my old job" --dry-run
synapse pack --topic project-x --range 30d

数据模型亮点（适用于API用户）

  • 情境回忆 (Synapse.recall)支持多种检索路径和查询选项。
  • 结构化三元组+图索引 可用于可解释性和一致性检查。
  • 矛盾检测和信仰谱系 揭露信任/冲突以供召回。
  • 范围政策 可以在运行时强制执行保守的输出行为。

Python示例

from synapse import Synapse

s = Synapse("~/.synapse/synapse_store")

# memory with scope
s.remember("Team deadline is Friday", scope="shared", shared_with=["team:ops"])

# compile context for downstream LLM call
pack = s.compile_context("Prepare a concise status update", budget=1800, policy="balanced")
system_prompt = pack.to_system_prompt()

# maintenance + safety
report = s.sleep(verbose=True)
print(report.to_digest())

兼容性和链接

  • 文件： 此README和 README_MCP.md
  • 示例： examples/, docs/, integrations/
  • 测验： tests/ 和 docs/benchmarks/
  • 可安装于： macOS/Linux（以及兼容的Python 3.10+）

安全和许可

看 安全.md.Sapse仍持有麻省理工学院的许可证 许可证.

相关 MCP