localgpt
Documents, songs and screenplays become walkable 3D worlds that you and your own coding agents edit together. A Rust desktop app on the Open World Format.
What is localgpt?
Documents, songs and screenplays become walkable 3D worlds that you and your own coding agents edit together. A Rust desktop app on the Open World Format.
Overview of localgpt
What it is
LocalGPT is a desktop application that turns documents, songs, screenplays, or prompts into walkable 3D worlds saved in the .world format. It is written in Rust and uses the Open World Format. The application does not run any language model, call any external service, or hold any API keys; users bring their own coding agents to edit the world from terminals beside the window. It is open source under the Apache 2.0 license.
Key features
- Converts a Markdown document, a song (MP3), a screenplay (PDF, Final Draft, Fountain, Markdown), or a prompt into a 3D world.
- Provides a live canvas where the window holds authority and serves the folder's API; every change is logged, attributed, undoable, and branchable.
- Includes a built-in MCP shim (
localgpt world mcp) that serves the open world's tools to any MCP-compatible agent over stdio. - Offers a timeline across the window to play the world's clock (song, shots, tour) and trim/move shots.
- Supports collaborative sessions on LAN or through a relay.
- Ships with a command-line tool (
localgpt) for committing, undoing, logging, verifying, taking screenshots, and running the MCP shim.
Use cases
- Turning a written document into an explorable 3D environment for review or presentation.
- Converting a song into a 3D world that visualizes its tempo, beat grid, sections, energy curve, and mood.
- Creating a previsualization of a screenplay scene-by-scene, with set, cast, coverage, a printable board, and a shot list.
- Allowing coding agents (e.g., Claude Code, Codex) to edit a 3D world by sending batches of operations to the live canvas API.
Getting started
bash# Prebuilt (no Rust toolchain needed)brew install --cask localgpt-app/tap/localgpt # macOS: LocalGPT.app + the `localgpt` CLInpm install -g localgpt # macOS, Linux, Windows: the `localgpt` CLI and MCP shim# From crates.iocargo install localgpt-gen # the world builder: MCP server, the relay, headless, sessionscargo install localgpt # `localgpt world`, the MCP shim (`world mcp`), and `localgpt previs`# From sourcegit clone https://github.com/localgpt-app/localgpt.gitcd localgpt(cd crates/app/ui && npm ci && npm run build)cargo run -p localgpt-app
License and pricing
The project is open source under the Apache 2.0 license. No pricing information is stated.
這是什麼
LocalGPT 是一款桌面應用程式,能將文件、歌曲、劇本或提示詞轉換為可走進的 3D 世界,並以 .world 格式儲存。它使用 Rust 語言開發,基於 Open World Format。此應用程式不執行任何語言模型、不呼叫外部服務、也不持有任何 API 金鑰;使用者自行帶入自己的編碼代理,在視窗旁的終端機中編輯世界。本專案以 Apache 2.0 授權開源。
主要功能
- 將 Markdown 文件、歌曲(MP3)、劇本(PDF、Final Draft、Fountain、Markdown)或提示詞轉換為 3D 世界。
- 提供即時畫布,視窗持有權威並提供資料夾的 API;每次變更都會被記錄、歸屬、可復原且可分支。
- 內建 MCP 橋接器(
localgpt world mcp),可透過 stdio 將開放世界的工具提供給任何相容 MCP 的代理。 - 視窗底部有時間軸,可播放世界的時鐘(歌曲、鏡頭、導覽),並修剪或移動鏡頭。
- 支援透過 LAN 或中繼進行協作工作階段。
- 附帶命令列工具(
localgpt),可進行提交、復原、記錄、驗證、截圖及執行 MCP 橋接器。
使用情境
- 將書面文件轉換為可探索的 3D 環境,用於審閱或簡報。
- 將歌曲轉換為 3D 世界,視覺化其節奏、節拍網格、段落、能量曲線與情緒。
- 逐場次建立劇本的預視化,包含場景、演員、鏡位表、可列印的分鏡板與鏡頭清單。
- 讓編碼代理(例如 Claude Code、Codex)透過傳送批次操作至即時畫布 API 來編輯 3D 世界。
快速開始
bash# 預先建置(無需 Rust 工具鏈)brew install --cask localgpt-app/tap/localgpt # macOS:LocalGPT.app + `localgpt` CLInpm install -g localgpt # macOS、Linux、Windows:`localgpt` CLI 與 MCP 橋接器# 從 crates.io 安裝cargo install localgpt-gen # 世界建構器:MCP 伺服器、中繼、無頭模式、工作階段cargo install localgpt # `localgpt world`、MCP 橋接器(`world mcp`)與 `localgpt previs`# 從原始碼建置git clone https://github.com/localgpt-app/localgpt.gitcd localgpt(cd crates/app/ui && npm ci && npm run build)cargo run -p localgpt-app
授權與價格
本專案以 Apache 2.0 授權開源。未提及任何價格資訊。
Based on the project's public README and repository metadata.