TrulyMEM - TrueHumanMEM

让 AI 拥有自知、可塑、有分寸感的长期记忆

The More Human Choice.

---

简介

TrulyMEM（TrueHumanMEM）是一个让 AI 拥有长期记忆能力的图记忆系统。通过图数据库存储实体关系，让AI能够像人类一样记忆、回忆和管理信息。

核心特性

• 🧠 长期记忆 - 基于图数据库的持久化记忆存储
• 🎭 人设图机制 - AI角色保持和角色扮演支持
• 🖥️ 现代化TUI - 基于Textual框架的终端用户界面
• 💾 内嵌数据库 - SQLite实现，无需Docker/Neo4j
• 🌐 Web接口 - 支持浏览器访问
• 🚀 流式显示 - 实时显示AI响应，减少等待
• 📦 独立部署 - 支持打包为独立可执行文件
• 🌍 跨平台 - 支持Windows/Linux/macOS

---

快速开始

方式一：使用可执行文件（推荐）

Windows:

# 下载 TrulyMEM.exe
# 双击运行或命令行执行
./TrulyMEM.exe

Linux:

# 下载 TrulyMEM
chmod +x TrulyMEM
./TrulyMEM

方式二：从源码运行

# 克隆仓库
git clone https://github.com/yourusername/trulymem.git
cd trulymem

# 安装依赖
pip install -r requirements.txt

# 运行应用
python -m graph_memory_tui.main

配置

1. 按 F2 展开侧边栏
2. 输入 API Key（支持DeepSeek、OpenAI等）
3. 按 Enter 保存配置
4. 开始对话！

---

功能说明

记忆管理工具

工具	功能	说明
memory_recall	检索记忆	根据意图查询相关记忆
memory_commit	写入记忆	将信息存储为图结构
memory_purge	删除记忆	删除过期或错误信息
memory_introspect	查看状态	查看记忆系统状态
memory_archive	归档记忆	归档旧记忆
memory_cleanup	清理数据	清理无效数据

人设图机制

AI会在每轮对话前查询人设图，严格按照人设回复，确保角色一致性。

使用示例：

用户：以猫娘的语气跟我说话
AI：喵~好的主人！我会用可爱的猫娘语气跟你说话的喵！(≧ω≦)

快捷键

快捷键	功能
F1	帮助
F2	切换侧边栏
F3	工具详情
F4	查询框
F5	清屏
F6	退出

---

项目结构

trulymem/
├── graph_memory_tui/      # TUI应用
│   ├── core/              # 核心逻辑
│   ├── handlers/          # 事件处理
│   ├── models/            # 数据模型
│   ├── services/          # 服务层
│   ├── widgets/           # UI组件
│   └── styles/            # 样式文件
├── docs/                  # 文档
├── tests/                 # 测试
├── requirements.txt       # 依赖清单
├── LICENSE               # 许可证
└── README.md             # 说明文档

---

技术栈

• Python 3.8+ - 编程语言
• Textual - TUI框架
• SQLite - 内嵌数据库
• Flask - Web框架
• OpenAI SDK - API调用

---

开发指南

环境设置

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

# 安装依赖
pip install -r requirements.txt

运行测试

pytest tests/

打包应用

# Windows
python build_windows.bat

# Linux
bash build_linux.sh

---

许可证

本项目采用 GNU General Public License v3.0 (GPLv3) 许可证开源。

详见 LICENSE 文件。

许可证要点：

• ✅ 可以自由使用、修改和分发
• ✅ 必须保留版权声明和许可证
• ✅ 修改后的作品必须以相同许可证发布
• ✅ 必须提供源代码

---

贡献

欢迎提交 Issue 和 Pull Request！

贡献指南

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request

---

作者

jianf - 项目设计与开发

---

致谢

感谢所有为这个项目做出贡献的开发者和用户。

---

TrulyMEM —— 让 AI 的记忆方式，更像人。

Made with ❤️ by jianf