TrulyMEM-TrueHumanMEM/docs/一键启动指南.md

TrulyMEM 一键启动指南

快速开始

Windows

# 方法1: 双击运行
双击 start.bat

# 方法2: 命令行
start.bat

# 方法3: Python
python trulymem_entry.py

Linux / macOS

# 方法1: Python直接运行
python3 trulymem_entry.py

# 方法2: 打包后的可执行文件
chmod +x TrulyMEM
./TrulyMEM

启动流程

[Step 1/3] 检查 Python
    ↓
[Step 2/3] 安装依赖
    - 安装 requirements.txt 中的依赖
    ↓
[Step 3/3] 启动应用
    ↓
✅ 系统初始化成功！

启动时间

• 首次启动: 约1-2分钟（安装依赖）
• 后续启动: 约30秒

系统要求

必需

• Python 3.8+
• DeepSeek API Key (或 OpenAI 兼容 API Key)

可选

• Git - 用于克隆仓库

首次使用

1. 启动应用

python trulymem_entry.py

2. 配置 API Key

1. 按 F2 展开侧边栏
2. 在 API Key 输入框输入密钥
3. 按 Enter 保存

3. 开始对话

• 在底部输入框输入消息
• 按 Enter 发送

获取 API Key

DeepSeek

1. 访问：https://platform.deepseek.com/
2. 注册账号
3. 创建 API Key
4. 复制密钥

其他兼容API

• OpenAI
• 其他兼容OpenAI格式的API（如 Azure OpenAI）

常见问题

Q: Python 未找到

A: 安装 Python 3.8+

• Windows: https://www.python.org/downloads/
• Linux: sudo apt install python3
• macOS: brew install python3

Q: 依赖安装失败

A: 手动安装

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate  # Windows
pip install -r requirements.txt

Q: API Key 无效

A: 检查API Key格式

• 应以 sk- 开头（DeepSeek/OpenAI）
• 无多余空格
• 正确复制

Q: 提示"请先配置API Key"

A: 按 F2 展开侧边栏，在 API Key 输入框中输入密钥后按 Enter

快捷键

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

数据存储

• 数据库: graph_memory.db
• 位置: 应用目录
• 格式: SQLite（内嵌，无需外部数据库）
• 可备份: 是，直接复制文件即可

更新应用

# 拉取最新代码
git pull

# 重新安装依赖（如有更新）
pip install -r requirements.txt

# 重新启动
python trulymem_entry.py

清理数据

# 删除数据库
rm graph_memory.db

# 重新启动会创建新数据库
python trulymem_entry.py

提示

• 首次启动需要安装依赖，请耐心等待
• API Key 只需配置一次（自动保存）
• 数据自动保存，无需手动操作
• 可以随时按 F6 退出

从源码运行

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

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

# 运行
python -m graph_memory_tui.main
# 或
python trulymem_entry.py

打包应用

Windows

python build_windows.bat

Linux

bash build_linux.sh

开始使用吧！