使用说明
光环涡轮
AI代理的压缩持久内存
给你的人工智能助手一个永远不会忘记的记忆,放在你的口袋里。
光环涡轮是 MCP(模型上下文协议) 为Claude和其他人工智能助手提供持久、压缩内存存储的服务器。内存在会话中存活,用zlib压缩以实现高效存储,并且可以通过关键字和标签进行搜索。
特性
- 持久内存 --重启后仍能存活的SQLite支持的存储
- zlib压缩 --文本内容的典型3-5x压缩
- 三个内存级别 —
core(永久),working(7天TTL),ephemeral(24小时TTL) - 基于标签的组织 --按标签对记忆进行分类和检索
- 关键字搜索 --TF IDF风格在所有记忆中的相关性评分
- 自动到期 --短暂和工作记忆会自行清理
- 去重 --内容哈希可防止两次存储相同的内存
- 零外部依赖 --仅使用Python stdlib(zlib、sqlite3)和MCP SDK
安装
pip install aura-turbo
或者克隆并直接运行:
git clone https://github.com/aura-turbo/aura-turbo.git
cd aura-turbo
pip install -e .
快速开始
直接运行服务器:
python server.py
Claude桌面配置
添加到您的Claude Desktop MCP配置(claude_desktop_config.json):
{
"mcpServers": {
"aura-turbo": {
"command": "python",
"args": ["/path/to/aura-turbo/server.py"]
}
}
}
或者,如果通过pip安装:
{
"mcpServers": {
"aura-turbo": {
"command": "aura-turbo"
}
}
}
自定义数据库位置
设置 AURA_TURBO_DB 使用自定义数据库路径的环境变量:
{
"mcpServers": {
"aura-turbo": {
"command": "python",
"args": ["/path/to/aura-turbo/server.py"],
"env": {
"AURA_TURBO_DB": "/path/to/my-memories.db"
}
}
}
}
默认位置: ~/.aura-turbo/memories.db
工具
memory_store
使用可选标签和重要性级别存储内存。
content: "The user prefers dark mode and uses vim keybindings"
tags: ["preferences", "editor"]
level: "core"
memory_recall
按关键字或短语搜索记忆。返回排名结果。
query: "editor preferences"
limit: 5
memory_forget
按ID删除特定内存。
memory_id: 42
memory_stats
显示存储统计数据——总内存、压缩比、节省的空间。
memory_search_by_tag
查找带有特定标签的所有记忆。
tag: "preferences"
memory_clear_expired
删除超过24小时的短暂记忆和超过7天的工作记忆。核心记忆永远不会被删除。
压缩是如何工作的
aura-turbo使用Python的内置 zlib 库(实现DEFLATE/gzip压缩)在将内存内容存储到SQLite之前对其进行压缩。
| 内容类型 | 典型比率 |
|---|---|
| 英语散文 | 3-4x |
| 代码片段 | 3-5x |
| JSON/结构化数据 | 4-6x |
| 已压缩 | ~1x |
1KB的对话摘要压缩到约250-300字节。在数百个内存中,这大大节省了空间,同时将所有内容保存在一个可移植的SQLite文件中。
比较
| 功能 | 光环涡轮 | Mem0 | 定制RAG |
|---|---|---|---|
| 价格 | 免费 | 249美元/月 | 各不相同 |
| 存储 | 本地SQLite | 云 | 云/本地 |
| 依赖关系 | 仅限MCP SDK | 许多 | 许多 |
| 压缩 | zlib(3-5x) | 无 | 无 |
| 设置时间 | 1分钟 | 帐户设置 | 小时 |
| 隐私权 | 100%本地 | 云 | 取决于 |
| MCP本机 | 是 | 否 | 否 |
建筑学
Claude/AI <--MCP--> server.py <--> storage.py <--> SQLite + zlib
|
~/.aura-turbo/
memories.db
许可证
麻省理工学院
