local-studio

sybil-solutionsMIT活跃维护

统一管理 VLLM、Sglang、llama.cpp、exllamav3 等本地大模型推理引擎的控制面板,省去逐个配置和切换的麻烦。

Control panel for VLLM, Sglang, llama.cpp, exllamav3

v3.0.3发布于 2026-10-05 11:09 UTC1,844star +4 / 7 天170fork同步于 2026-11-10 17:48 UTC

怎么上手

由 README 提炼,执行前请确认
从 GitHub Releases 下载对应平台安装包(如 Local-Studio-mac-arm64.dmg、Local-Studio-win-x64.exe、Local-Studio-linux-x64.AppImage)安装;首次使用前需安装并登录至少一个 agent CLI,Pi 装 pi,Oh My Pi 装 omp
硬件要求按 README 说明

README 未给出具体显存要求;启动 registry 配方需要空闲的 NVIDIA GPU,控制器本身可跑在 Linux/macOS/Windows 上,远端机器需 Linux 或 macOS 并开放基于密钥的 ssh。

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

自托管模型推理服务器的统一控制面板,把 vLLM、SGLang、llama.cpp 等引擎接入一个兼容 OpenAI 的网关

统一管理 VLLM、Sglang、llama.cpp、exllamav3 等本地大模型推理引擎的控制面板,省去逐个配置和切换的麻烦。

核心能力

  • 自动发现各机器上的 vLLM、SGLang、llama.cpp 等 /v1/models 服务
  • 通过单一 OpenAI/Anthropic 兼容网关转发流式请求
  • 在空闲 NVIDIA GPU 上按固定 registry 配方启动推理服务
  • 经 Tailscale 组网,一键 ssh 安装并连接远端控制器
  • 模型 id 填 auto 自动路由到请求成功率最高的在线模型

容易踩的坑

首次使用前必须先安装并登录至少一个 agent CLI(pi 或 omp),否则无法使用;Windows 安装包未签名,SmartScreen 会弹确认;桌面端控制器固定占用 127.0.0.1:18091 并会替换该端口上的旧控制器;一键安装远端控制器需要目标机器已配置基于密钥的 ssh 访问。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v3.0.3
  1. v3.0.3Local Studio 3.0.3最新正式版2026-10-05 · 2026-10-05 11:09 UTC

    Local Studio 3.0.3

    This release corrects where 3.0.2 keeps your data.

    • The data folder is now ~/.local-studio-t3. 3.0.2 used ~/.local-studio, but that folder belongs to Local Studio 2.x, so 3.x data ended up inside it. Anyone who had run 2.x also skipped the one-time copy of their threads. All 3.x state now lives in ~/.local-studio-t3, next to the controller's config.json.
    • First launch copies your existing data. If ~/.local-studio-t3/userdata doesn't exist yet, Local Studio copies it once from 3.0.2's location (~/.local-studio/userdata), or else from ~/.t3/userdata. Originals are left untouched, and your 2.x folder isn't modified.

    Everything from 3.0.2 still applies: the app runs its own controller and replaces any older Local Studio controller it finds on its port.

    Download: localstudio.ai/download or the assets below. 3.0.x installs update themselves.

    Test reports: #473

    Full changelog: https://github.com/sybil-solutions/local-studio/compare/v3.0.2...v3.0.3

  2. v3.0.2Local Studio 3.0.22026-10-05 · 2026-10-05 10:45 UTC
    查看更新说明

    Local Studio 3.0.2

    This release fixes how Local Studio starts its controller and where it keeps your data.

    Download: localstudio.ai/download or the assets below.

    Fixes

    • The app owns its controller. On launch, Local Studio checks the controller on its port. An older Local Studio controller is stopped and replaced with the current one, so new features never hit a stale controller (for example, a "NOT_FOUND /api/registry" error in Settings → Local). Packaged apps run the bundled controller; source builds run it with Bun. It stops when the app quits. Anything on the port that isn't a Local Studio controller is never touched.
    • Separate data folder. Local Studio now keeps its data in ~/.local-studio, no longer in ~/.t3, which upstream T3 Code also uses. Before this, installing both apps meant they shared one database and one set of sign-ins. On first launch, 3.0.2 copies your existing ~/.t3/userdata into the new folder once, so your threads come along. The original is left untouched.

    Upgrading

    • From 3.0.0 or 3.0.1: the app updates itself, then copies your data on first launch.
    • From 2.x: install from the link above.

    Test reports: #473

    Full changelog: https://github.com/sybil-solutions/local-studio/compare/v3.0.1...v3.0.2

  3. v3.0.1Local Studio 3.0.12026-10-04 · 2026-10-04 21:48 UTC
    查看更新说明

    Local Studio 3.0.1

    A follow-up to 3.0.0. It fixes branding and brings the local-ai-registry features ported from community PRs.

    Download: localstudio.ai/download · macOS Apple silicon · macOS Intel · Windows · Linux x64 · Linux arm64

    Local Studio's own icon and name

    3.0.0 shipped with upstream T3 Code's app icon and still said "T3 Code" in several places. 3.0.1 uses the Local Studio cube everywhere:

    • App icons on macOS, Windows and Linux, plus the web favicons and touch icon. The cube was redrawn as a vector from the 2.x icon.
    • Development builds (Local Studio Dev) use the same cube in blue.
    • Names in the app: the welcome wizard, the label on assistant messages, the timeline icon for app tools, the name a browser or phone sees, device names under Settings → Connections, the startup error and shutdown dialogs, and the macOS permission helper.

    Local Studio is still built on T3 Code, with full credit in the README and the 3.0.0 notes. It just no longer wears T3's logo.

    local-ai-registry in Settings → Local

    These features are ported from community PRs #449 by @gildrb and #465 by @BlivionIaG, via #477. Thank you both.

    • Recommendations: your GPUs, or your Apple chip and its unified memory, are matched against local-ai-registry hardware records, so you see what has been validated on a machine like yours.
    • Model browser: turn on "All hardware" to browse every registry model, grouped by model, with the best variant first and every variant one click away.
    • Per variant:
      • Inspect shows the full registry records.
      • Use config copies the launch command.
      • Download weights fetches the pinned revision onto that machine.
    • Share: give a working setup back to the registry. Share turns a running server into registry records.
      • It removes credentials, home paths, hostnames and private IPs, then checks the records against the registry's own schemas.
      • Nothing is sent until you confirm. The pull request to local-ai-registry opens with your own gh login.

    Other changes

    • Controller docs again explain read-only captured recipes, cancellation limits and how auto ranks models (#475).
    • The README download table points straight at the release files (#474).
    • localstudio.ai now runs on Cloudflare and has a download page for every platform.

    Upgrading

    • From 3.0.0: the app updates itself.
    • From 2.x: install 3.0.1 from the links above. See the 3.0.0 notes for what changed.

    Please keep test reports coming in #473.

    Full changelog: https://github.com/sybil-solutions/local-studio/compare/v3.0.0...v3.0.1

  4. v3.0.0Local Studio 3.02026-10-03 · 2026-10-03 14:20 UTC
    查看更新说明

    Local Studio 3.0

    Local Studio 3.0 is a new app. The custom interface we built through 2.x is replaced by T3 Code, the open-source agent harness from Theo Browne, Julius Marminge and the T3 Tools team. On top of it, Local Studio adds what it has always been about: your own models, on your own machines.

    Credit where it's due. Almost everything you see — the thread UI, the composer, the terminal, source control, remote access, the mobile app — is T3 Code's work, used under the MIT License. Local Studio is a deliberately thin fork that tracks upstream closely. If you like it, star pingdotgg/t3code.

    Download: localstudio.ai/download · macOS Apple silicon · macOS Intel · Windows · Linux x64 · Linux arm64. All files, including the .deb packages and controller binaries, are listed under Assets below.

    Watch the one-minute tour: Local-Studio-3.0-launch.mp4 (vertical)


    Why we rebuilt on T3 Code

    2.x grew a lot of UI over a year: chat panes, agent dashboards, a custom session model, a Next.js frontend, an Electron shell, and a controller with dozens of modules. It worked, but every feature cost us twice: once to build and again to keep fast and correct. Long agent sessions were where it hurt most. Ordering of reasoning and tool calls, reconnects, streaming and long-thread performance each needed their own fixes, again and again.

    T3 Code had already solved the hard parts of an agent UI, and solved them well:

    • Fast in long threads. On a 209-message, 282k-token session, the thread opens with about 90 ms of main-thread work. A follow-up turn shows your message in about 20 ms and streams without dropped frames.
    • Every major agent. Codex, Claude Code, Cursor, Grok, OpenCode and Antigravity work out of the box.
    • Remote-ready. One server drives desktop, web and phone, with pairing, Tailscale and a published mobile app.
    • Maintained in the open by people who use it every day.

    So we stopped competing with that and contributed the part we're good at. Local Studio 3.0 is T3 Code plus local AI, kept under a strict 4,000-line budget of our own code, so that upstream improvements reach you quickly.

    What's new

    Pi and Oh My Pi as first-class providers

    Pi and Oh My Pi now sit in the model picker next to Codex and Claude, and run on whatever models you've configured for them, local or remote.

    • Streaming text and reasoning, with tool calls (shell, edits, MCP) shown as they happen
    • Interrupt, steering, and native compaction
    • Conversation rollback for both Pi and Oh My Pi
    • Effective model and thinking level, read back from the CLI, so the UI always shows what is actually running
    • Token usage and context-window tracking from each session's own stats
    • Import existing Pi and Oh My Pi sessions during onboarding, so your history comes with you
    • No approval prompts interrupting long autonomous runs
    • Oh My Pi's large model catalogs (hundreds of models) now load reliably, using its chunked RPC protocol

    A local controller, bundled

    The desktop app ships with the Local Studio controller and starts it for you.

    • It discovers every OpenAI-c
  5. v2.16.02026-09-02 · 2026-09-02 21:03 UTC
    查看更新说明

    2.16.0 (2026-09-02)

    Features

    • agent: transcript subagents, live status panel, repo slimming, and readable automation (#442) (c0d224b)
    • app: cursor-wave 4 — sidebar redesign, composer dedupe, title generation, controller guards (#461) (9bf7b34), closes #141414 #181818 #599CE7 #F0F0F013
    • app: owner-reported fixes, subagent panel redesign, composer density, and build hardening (#438) (cacf503)
    • controller: context soft-limit guard and scaled local compaction (#460) (0b916f5)

    Fixes

    • agent-runtime: wait for the goal driver to settle instead of sleeping (#441) (bbc2039)
    • agent: require strict goal outcome sentinels (#439) (6a6ece0)
    • controller: make custom Docker launches reliable (#458) (4e48cc7)
    • controller: strip accelerator prefix from CUDA selectors (#459) (0f9ad44)
    • providers: salvage the still-relevant pieces of #435 (#440) (ba9fe13)

    Refactors

    • registry-backed recipes, docker-only engine roster, unified passthrough proxy (#443) (6ff4ef9)

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Local Studio

    Built on T3 Code by Theo Browne, Julius Marminge and the T3 Tools team, used under the MIT License (Copyright (c) 2026 T3 Tools Inc.). Local Studio is a thin fork that tracks upstream T3 Code closely. Almost all of the app — the agent UI, providers, threads, terminal, source control, remote access and mobile app — is their work. Please star and support the upstream project.

    Local Studio is T3 Code for people who run their own models. It adds:

    • Pi and Oh My Pi providers. Both run next to Codex, Claude, Cursor, Grok, OpenCode and Antigravity. They support streaming, tool calls, reasoning, interrupt, compaction, rollback, model/thinking selection, session import and token usage.
    • A bundled local controller. It discovers the inference servers on each machine (vLLM, SGLang, llama.cpp, anything serving /v1/models) and exposes them through one OpenAI/Anthropic-compatible gateway. It can launch pinned registry recipes on free NVIDIA GPUs.
    • A machine fleet over Tailscale. Settings → Local finds the devices on your tailnet and connects existing controllers. On Linux and macOS machines that have none, it installs a controller with one click, so a model loaded on any machine is usable from every machine.

    LOCAL_STUDIO_UPSTREAM.json records the pinned upstream import. node scripts/local-check.mjs --budget keeps Local Studio's own source under 4,000 lines on top of it, so upstream updates stay easy to merge.

    Download

    Get the latest release from GitHub Releases. Every installer, .deb package and controller binary is listed there:

    PlatformInstaller
    macOS, Apple siliconLocal-Studio-mac-arm64.dmg
    macOS, IntelLocal-Studio-mac-x64.dmg
    Windows x64Local-Studio-win-x64.exe
    Linux x64Local-Studio-linux-x64.AppImage
    Linux arm64Local-Studio-linux-arm64.AppImage

    macOS builds are signed and notarized. Windows builds are not yet code-signed, so SmartScreen asks for confirmation. Each release also attaches SHA256SUMS and standalone controller binaries for Linux, macOS and Windows.

    Install and log in to at least one agent CLI before first use. For Pi, install pi; for Oh My Pi, install omp. Both use their own configured models and credentials. The other providers are covered in the upstream provider guides.

    Local models and the fleet

    The desktop app runs its own controller on 127.0.0.1:18091, replacing any older Local Studio controller it finds there. Its configuration lives in ~/.local-studio-t3/config.json (mode 0600). That file holds the machine name, the controller URL, the private fleetKey and the linked peers.

    Open Settings → Local to see every connected machine with its GPUs, live models, launchable recipes and usage. Machines on your tailnet appear automatically:

    • Connect: the machine already runs a controller; this links it.
    • Install: the machine is Linux or macOS with no controller. Local Studio installs one over ssh as a user service (systemd or launchd), binds it to the machine's Tailscale address, gives it your fleet key, and links it. This needs key-based ssh access to that machine. Machines that already have a controller are never overwritten.

    Every controller serves /v1/models, /v1/chat/completions, /v1/completions, /v1/messages and /v1/responses. Requests stream through to the engine that holds the model, on whichever machine it runs. The model id auto picks the live model with the most successful requests. Keep the fleet key private. More detail is in docs/local-studio/controller.md.

    Phone and tablet

    The T3 Code mobile app (Android) connects to Local Studio like any T3 Code environment. Pair it from Settings → Connections; over Tailscale, use the machine's tailnet address. See remote access.

    Development

    Use Node 24, pnpm 11 and Bun 1.3.14.

    pnpm install
    pnpm --filter @local-studio/controller start
    pnpm dev:desktop --port 18773 --home-dir .t3
    

    dev:desktop opens Local Studio Dev with hot reload and its own state. It runs React in development mode, which is many times slower in long threads. For daily use, build and run the production app instead:

    pnpm build:desktop
    T3CODE_HOME="$PWD/.t3" pnpm start:desktop   # installed builds keep data in ~/.local-studio-t3
    

    node scripts/local-check.mjs runs the type checks, the web build, the controller end-to-end checks and the source budget. Upstream development notes are in docs/operations/development.md.

    Releases

    .github/workflows/release.yml builds and publishes a release from a vX.Y.Z tag or a manual run. It produces:

    • signed and notarized macOS DMGs for arm64 and x64
    • a Windows NSIS installer
    • Linux AppImage and .deb packages for x64 and arm64
    • controller binaries
    • updater manifests and checksums

    The process is in docs/local-studio/release.md.

    Upstream T3 Code

    The docs/ folder is upstream's documentation and still describes most of the app. Upstream's own builds, install script (t3.codes), package-manager entries and T3 Connect service belong to T3 Tools. Local Studio does not publish to them.

    License

    MIT. See LICENSE. Copyright (c) 2026 T3 Tools Inc. for T3 Code. Local Studio changes are released under the same license. Oh My Pi's license is in assets/OMP-LICENSE.txt.