English | [中文](./README.zh-CN.md)
[](https://github.com/deer-flow/llm-space/actions/workflows/ci.yml)
[](https://github.com/deer-flow/llm-space/releases)
[](./package.json)
[](./mise.toml)
[](./LICENSE)
---
# LLM Space 4
https://github.com/user-attachments/assets/2ba7a600-1f1a-44c0-b9f1-34ad42100213
[**LLM Space** v4](https://github.com/deer-flow/llm-space) is a desktop app for agent builders — prototype your next agent ideas, inspect every step of your harness execution, debug failures, and evaluate performance, all in one place.
**Official website:** https://deer-flow.github.io/llm-space/
LLM Space is a sister project of [DeerFlow](https://github.com/bytedance/deer-flow), and we dogfood it heavily: every version of DeerFlow is built and debugged with LLM Space. The project started in March 2023, and v4 is its fourth major iteration.
## Contents
- [Features](#features)
- [Tech stack](#tech-stack)
- [Project layout](#project-layout)
- [Download](#download)
- [Install](#install)
- [Run the app](#run-the-app)
- [User guide](#user-guide)
- [Contributing](#contributing)
- [Sponsors](#sponsors)
- [Donate](#donate)
- [License](#license)
## Features
- **Build** — write and version your prompts, system messages, tools, and model settings.
- **Trace** — see every model call and tool run inside the agent loop as it happens.
- **Debug** — replay a run from history and step through it to find what went wrong.
- **Evaluate** — measure how your agent performs across runs.
- **Manage** — keep your threads organized as files on your own machine.
- **Generate** — let AI write your prompt and tools for you, and even turn any thread into a runnable [LangGraph](https://github.com/langchain-ai/langgraph) agent.
Your files and API keys stay on your local computer. LLM Space collects a small amount of anonymous usage data to improve the app - see [TELEMETRY.md](./TELEMETRY.md) for exactly what is collected and how to opt out.
## Tech stack
- **Language & tooling** — TypeScript, built and managed with [Bun](https://bun.com).
- **Desktop shell** — [Electrobun](https://electrobun.dev), a lightweight way to ship a native app.
- **UI** — React with Tailwind CSS and shadcn/ui.
- **Agent framework** — [Pi Agent Core](https://github.com/earendil-works/pi), a lightweight agent framework for building agents.
## Project layout
LLM Space is a Bun monorepo:
```
packages/
core/ # Shared logic: types, the agent loop, thread storage
apps/
desktop/ # The desktop app (Electrobun shell + React UI)
```
## Download
Grab a DMG from the [latest release](https://github.com/deer-flow/llm-space/releases/latest) — macOS, Apple Silicon and Intel. It comes in two editions:
- **LLM Space** — uses the system WebView. Small download (~27 MB), light on memory and battery.
- **LLM Space Performance** — embeds its own rendering engine (~130 MB). Rendering stays consistent across macOS versions, and usually performs better.
Install either, or both. They share the same `~/.llm-space` data, so switching editions keeps your threads and settings, and both update themselves in place.
## Install
Building from source? You need [Bun](https://bun.com) first. Bun is a fast, all-in-one runtime and package manager for JavaScript — think of it as a drop-in replacement for Node.js and npm. Follow the [official install guide](https://bun.com/docs/installation).
Once Bun is ready, install the project from the repo root:
```bash
bun install
```
Contributing, or want the exact toolchain CI uses? Install [mise](https://mise.jdx.dev) and run `mise run setup` instead — it installs the locked Bun version (from `mise.lock`) plus JS deps in one step.
## Run the app
Start the desktop app for local development:
```bash
mise run dev
```
Build a canary release:
```bash
mise run build:canary
```
## User guide
The user guide lives in this repository:
- [Quick start](./docs/get-started.md)
- [User manual](./docs/index.md)
- [Core concepts](./docs/core-concepts.md)
## Contributing
For now, we only merge pull requests from the [DeerFlow](https://github.com/bytedance/deer-flow) core team members.
Everyone else is very welcome to help by [opening an issue](https://github.com/deer-flow/llm-space/issues) — bug reports, ideas, and feedback all make the project better.
## Sponsors
LLM Space is free and open source, and it stays that way thanks to our sponsors. We are proud and grateful to be backed by them.
### 🏆 Platinum sponsor
Superdesign is an AI product design agent that turns natural-language prompts into UI mockups, components, and full designs on an infinite canvas. Thank you for making LLM Space possible. 💜
Want to see your logo here? We would love to talk - [reach out by opening an issue](https://github.com/deer-flow/llm-space/issues) or [support the project](#donate).
### 🏅 Gold sponsor
We strongly recommend using the VolcEngine Coding Plan as your default model provider:
- [BytePlus's Coding Plan by ByteDance](https://www.byteplus.com/en/activity/codingplan?utm_campaign=LLM_Space&utm_content=LLM_Space&utm_medium=devrel&utm_source=OWO&utm_term=LLM_Space)
- [火山引擎 Coding Plan - 中国大陆地区](https://ai.volcengine.com/activity/agentplan?utm_campaign=LLM_Space&utm_content=LLM_Space&utm_medium=devrel&utm_source=OWO&utm_term=LLM_Space)
## Donate
If LLM Space is useful to you and you would like to support its development, you can donate here:
**[Support LLM Space →](https://my.feishu.cn/wiki/OvLBwVuSkiCR1ik5wGEcBXZfnye)**
Thank you.
## License
LLM Space is released under the [MIT License](LICENSE).