localgpt-app/localgpt

LocalGPT – AI 优先的 3D 世界构建器与纯本地助手

它是什么 – 一个基于 Rust 的单一二进制应用程序，让您可以：

• 生成可探索的 3D 场景：使用 Bevy 游戏引擎，通过自然语言提示生成（localgpt-gen）。
• 运行本地 AI 助手：具备持久化、可搜索记忆、自主后台任务及轻量级 HTTP API（localgpt）。

这两个组件完全在您的机器上运行——无需 Docker、Node 或 Python——并且可以与您指定的任何 LLM（Ollama、LM Studio、OpenAI、Anthropic 等）对接。

---

快速入门 (用户)

# 安装世界构建器二进制文件
cargo install localgpt-gen
# 安装助手二进制文件
cargo install localgpt

运行提示驱动的场景：

localgpt-gen "Create a desert scene with pyramids and a UFO hovering above"

启动聊天助手：

localgpt chat          # 交互式 REPL
localgpt ask "What is the meaning of life?"
localgpt daemon start  # 启动 HTTP API + Web UI

---

核心功能

组件	亮点
Gen 模式	参数化图元、PBR 材质、灯光、行为（轨道、旋转、路径跟随）、环境音效、导出为 glTF/GLB 或 HTML、无头批处理模式、用于 IDE 集成的 MCP 服务器
AI 助手	基于 Markdown 的持久化知识库、全文 + 语义搜索（SQLite FTS5 + sqlite-vec）、自主心跳任务队列、多接口（CLI、Web UI、桌面 GUI、移动设备）、沙盒执行（Landlock/seccomp, Seatbelt）、提示注入防御
LLM 支持	适用于任何本地或云端供应商 – LM Studio、Ollama、Anthropic、OpenAI、xAI、GLM、Vertex AI 以及通用 CLI 供应商
安全性	内核强制沙盒、HMAC 签名策略文件、审计链日志
可扩展性	技能系统 – 您可以将整个世界保存为可重复使用的“技能”，记忆系统会在不同会话中学习您的风格（调色板、灯光、模板）

---

典型使用场景

• 游戏或 VR 的快速原型设计 – 用简单的英文描述场景，即可获得可立即运行的 Bevy 项目。
• 创意头脑风暴 – 在无头模式下迭代多种变体，用于批处理生成或 CI 流水线。
• 个人知识助手 – 将笔记、代码片段或研究存储在本地、可搜索的记忆中，并可通过 CLI 或 HTTP 查询。
• 自动化 – 让守护进程的心跳执行后台任务（例如：获取网页数据、更新世界），无需用户交互。

---

运作原理

• Rust + Tokio – 用于守护进程和生成器的异步执行环境。
• Bevy – 基于 ECS 的游戏引擎，用于构建 3D 场景。
• SQLite – 存储 Markdown 记忆；FTS5 用于关键字搜索，sqlite-vec 用于基于嵌入的语义搜索（嵌入由 fastembed 产生）。
• Axum – 轻量级 HTTP 服务器，提供 Web UI 和 JSON 端点。
• eframe – 可选的原生 GUI 前端。

---

文档与社区

• 完整文档 – https://localgpt.app/docs
• Discord – https://discord.gg/spKRr6mRyp
• YouTube 演示 – https://www.youtube.com/watch?v=R__tg7YY0T8
• 博客文章 – 解释“世界即技能”的概念以及 4 个晚上的快速开发故事。

---

授权

Apache-2.0 – 个人与商业用途皆免费。