这个项目能做什么

LocalGPT 是一款用 Rust 编写的开源、本地优先 AI 助手,以单一二进制文件分发,无需 Node.js、Docker 或 Python。它包含两个主要组件:AI 助手和世界构建工具。 AI 助手(localgpt) - 界面:交互式 CLI 聊天、单问题模式,以及一个守护进程,提供内嵌网页 UI 和 HTTP API(聊天、SSE 流式聊天、记忆搜索)。 - 持久记忆:基于 markdown 的工作区,包含 MEMORY.md、HEARTBEAT.md(自主任务队列)、SOUL.md(个性指导)以及 knowledge/ 知识库。文件通过 SQLite FTS5 建立关键词搜索索引,并使用 sqlite-vec 结合本地嵌入进行语义搜索。 - 自主心跳:任务可被委派并在后台运行。 - 提供商:LM Studio、Ollama、Anthropic、OpenAI、xAI、GLM、Vertex AI 以及 CLI 提供商;配置位于 config.toml,路径遵循 XDG 规范。 - 安全:内核级沙箱(Linux 上使用 Landlock/seccomp,macOS 上使用 Seatbelt)、受保护的 POLICY.md 常驻指令,以及提示注入防御,如标记剥离和内容边界。 Gen 模式(localgpt-gen) - 基于 Bevy 引擎,从自然语言提示构建可探索的 3D 世界。 - 支持参数化形状(box、sphere、cylinder、capsule、plane、torus、pyramid、tetrahedron、icosahedron、wedge)、PBR 材质、点光/聚光/平行光、行为(orbit、spin、bob、look_at、pulse、path_follow、bounce),以及环境音或空间音频。 - 导出 glTF/GLB、可在浏览器中查看的 HTML 和截图;世界可保存并加载为可复用技能。 - 无头模式和实验队列允许在无窗口情况下批量生成,适用于通宵运行或 CI 流水线;记忆系统可跨会话学习风格偏好。 - MCP 服务器让 Gen 可从 Claude Desktop、Codex Desktop 以及兼容 MCP 的编辑器(如 VS Code、Zed 和 Cursor)中使用,并提供面向命令行工具的 CLI 中继模式。 安装可通过 crates.io(cargo install localgpt-gen、cargo install localgpt)或从源码使用 cargo run。该项目采用 Apache-2.0 许可证,使用 Rust、Tokio、Axum、Bevy、SQLite(FTS5 + sqlite-vec)、fastembed 和 eframe 构建。