指南 · 8 分钟

开始使用

安装 Mneme,建立本地索引,然后启动双语终端 UI。最小的有效路径,从你已经拥有的文件开始。

开始前

Mneme 需要 Python 3.10 或更高版本;使用回答生成、查询拆解或 Graph RAG 实体提取时,还需要一个 OpenAI-compatible 端点。索引和检索本身可以在本地准备。

一条重要边界

不要把 API key、密码或其他 secret 放进要索引的目录。只有使用 LLM 能力时,检索片段才会发送到你配置的端点。

安装

git clone https://github.com/realhenrylan/mneme.git\ncd mneme\npython -m venv .venv\n\n# Windows PowerShell\n.venv\Scripts\Activate.ps1\n\n# macOS / Linux\nsource .venv/bin/activate\n\npython -m pip install -e ".[dev]"

配置端点

复制环境变量示例并设置最小连接信息。首次启动时,也可以使用 onboarding wizard 保存配置。

copy .env.example .env       # Windows PowerShell\n# cp .env.example .env       # macOS / Linux\n\nAPI_KEY=sk-your-api-key-here\nBASE_URL=https://api.deepseek.com/v1\nLLM_MODEL=deepseek-chat

非本地端点默认必须使用 HTTPS。本机回环地址可以使用 HTTP;非本地 HTTP 需要显式设置 override。

启动 TUI

python -m tui

TUI 支持流式对话、Standard RAG 与 Graph RAG、文件管理、目录监视、设置和来源展示。

下一步

搜索 Mneme 文档