# OpenBitFun (openBitFun/OpenBitFun)

> OpenBitFun is an open-source, highly customizable agent workspace built around a Rust-based agent runtime and a desktop app, meant for general work beyond just software development.

- GitHub: https://github.com/openBitFun/OpenBitFun
- GitHub.Locker page: https://github.locker/openBitFun/OpenBitFun
- Stars: 4.1K
- Language: Rust
- License: MIT
- Last push: 2026-11-18

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is this a full desktop app or just a runtime library?**

It's a complete workspace: a Rust agent runtime plus a desktop app and CLI that share the same execution capabilities, not a library you import into another project.

**How do I get it running?**

Download the Windows, macOS, or Linux package from the official download page, install it, configure a model, and open a workspace.

**Does upgrading from the old 0.2.x release just work?**

No, 1.0.0 is not data-compatible with legacy 0.2.x, so you need the OpenBitFun Data Tools to migrate, and those currently only support stable releases 0.2.17-0.2.19.

**Can I keep working on the same task from my phone or a browser?**

Yes, you can start a task on desktop and continue it from a mobile device or a browser; the work keeps running on whichever device is executing it, with cross-device sync handled by a Relay server you deploy yourself.

**What do the four Agent Harness modes do?**

Minimal handles quick direct collaboration, Standard breaks everyday multi-step tasks into plan-work-check cycles, Ultimate splits complex problems across multiple agents, and Creative is for building Mini Apps and customizing the workspace itself.

**What is a Mini App?**

A Mini App pairs a small dedicated interface with an agent conversation, so you describe a need (like a Git insights panel), the agent builds a tool, and you keep refining it through chat; you can reuse your own apps or browse the Mini App Marketplace.

**How well does it perform on coding benchmarks?**

In a DeepSWE v1.1 evaluation, OpenBitFun scored a 64.6% pass rate with GLM-5.3-Flash (42.9 min median runtime) and a 56.6% pass rate with DeepSeek-V4-Flash (19.6 min median runtime).

**Can I customize or extend OpenBitFun itself?**

Yes, you can build specialist agents, connect tools via MCP, turn workflows into Skills, use Hooks, install UI skins, or even ask OpenBitFun's own Code Agent to modify its interface and runtime source.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/openBitFun/OpenBitFun/blob/main/README.md

**English** · [中文](README.zh-CN.md) · [日本語](README.ja.md)

<div align="center">

<img src="./png/openbitfun-wordmark.png" alt="OpenBitFun" width="520" />

### Built to keep going.

OpenBitFun is a highly customizable, open-source agent workspace that keeps work moving your way.

**Four powerful Agent Harness modes** · **Cross-device remote control** · **Customization from Mini Apps to source**

**If this is the kind of agent workspace you want, ⭐ Star OpenBitFun and help more people discover it.**

[Download Desktop](https://openbitfun.com/download) · [Mobile Releases](https://github.com/GCWing/OpenBitFun/releases?q=mobile-&expanded=true) · [Mini App Marketplace](https://market.openbitfun.com/miniapp/) · [Join the community](#join-the-community) · [Contribute](./CONTRIBUTING.md)

[![Website](https://img.shields.io/badge/Website-openbitfun.com-0b7285?style=flat-square)](https://openbitfun.com/)
[![Core code: MIT](https://img.shields.io/badge/core_code-MIT-yellow?style=flat-square)](./LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue?style=flat-square)](https://openbitfun.com/download)

[![Trendshift](https://trendshift.io/api/badge/repositories/44672)](https://trendshift.io/repositories/44672)

## Join the community

Scan the QR code with WeChat to add us and request to join the OpenBitFun community group.

<a href="./png/openbitfun-community-wechat.png">
  <img src="./png/openbitfun-community-wechat.png" alt="WeChat QR code for joining the OpenBitFun community" width="147" />
</a>

</div>

---

<div align="center">
  <video src="https://github.com/user-attachments/assets/ff1780fa-d248-40f1-9582-82e0de3d2f46" controls width="800"></video>
</div>

---

<p align="center">
  <img src="./png/openbitfun-desktop.png" alt="The OpenBitFun desktop home screen" width="49%" />
  <img src="./png/openbitfun-desktop-session.png" alt="The OpenBitFun desktop multi-agent session" width="49%" />
  <br />
  <img src="./png/openbitfun-desktop-settings.png" alt="The OpenBitFun desktop settings screen" width="49%" />
  <img src="./png/openbitfun-desktop-task-board.png" alt="The OpenBitFun desktop task board" width="49%" />
</p>

## Four modes for the way you work

**The Agent Harness shapes how a task gets done.** It plans steps, manages context, calls tools, coordinates agents, and brings their results together. Choose the mode that fits the task:

![Four working modes: Minimal, Standard, Ultimate, and Creative](./png/openbitfun-harness-modes.png)

| Mode | When to use it |
| --- | --- |
| **Minimal** | **Quick collaboration.** Start with a clear goal. The agent acts directly, you give feedback, and you refine the work together. |
| **Standard** | **Everyday tasks.** For work with several steps: plan the approach, work through it, and check the results. |
| **Ultimate** | **Complex tasks.** Dig into demanding problems, divide the work among agents, and bring their results together. |
| **Creative** | **Creation and customization.** Build Mini Apps or extend OpenBitFun's interface and capabilities to make the workspace your own. |

## Switch computers. Control from your phone.

**Switch the device, switch the entire workspace.** Choose another connected computer in the desktop app, and the interface switches to that device's sessions, workspaces, files, and task status. Move between your home computer, office computer, and server from the same app.

**Your phone is a remote controller.** Send instructions, check progress, and respond to approval requests from your phone or browser. Tasks run on the selected host and keep going when you switch views or disconnect the controller.

**The official Relay is ready to use; no server deployment is required.** Sign in on your devices with the same OpenBitFun account, using GitHub or an email verification code where supported. Same-network connections are also available. See the [connection FAQ](./src/apps/relay-server/FAQ.md) for login, internet access, and self-hosting requirements.

**On mobile, switch between layouts for one, two, or three screens.** Focus on the conversation with a single screen, then unfold your phone to view conversations and files side by side. The interface adapts as the screen layout changes.

![Switching between connected computers and remotely controlling the selected device from a phone](./png/openbitfun-multi-device.png)

<details>
<summary>Connection and deployment details</summary>

Use SSH to work on a remote host, through a jump host, or inside a container. File access, terminals, and workspace commands target that environment; the Agent Runtime stays on the OpenBitFun host. The desktop app and CLI share core execution capabilities; mobile clients and messaging bots offer more ways to control tasks.

Same-account device control uses the official Relay by default. Desktop can also run a local Relay for same-network mobile control. Both paths use the online OpenBitFun identity service for sign-in; LAN mode is not an offline-login option. A private Relay requires a matching client build: see the [deployment guide](./src/apps/relay-server/README.md#for-community-developers-and-forks).

Device-to-device payloads are encrypted end to end with keys generated on the devices. Sessions and files are read from the owning online device on demand; the Relay still handles account, device, and routing metadata. This does not cover traffic to model providers, messaging bots, or published Pages. See the [privacy boundaries](./src/apps/relay-server/FAQ.md#what-can-the-services-see), [Remote Connect](./docs/interactive-capabilities/capabilities/feature.remote-connect.md), and [remote workspaces](./docs/features/remote-workspaces.md).

</details>

## Turn everyday needs into useful apps

Build a Git insights panel for a repository, a workspace for presentations, or a form that brings routine actions together. **Mini Apps turn specific needs into tools you can use.**

Describe what you need and let the agent build it. Each Mini App pairs a dedicated interface with an agent conversation, so you can use the app for everyday work and keep improving it through chat.

Install and reuse the apps you build, or explore the [Mini App Marketplace](https://market.openbitfun.com/miniapp/) for tools that fit your work.

## Extend OpenBitFun with OpenBitFun

**Customize the roles, tools, interface, and source code.** Start with an agent that fits your work, then extend the workspace around it:

- **Build a specialist agent.** Choose a model, define its role, and equip it with the tools and workflows it needs for motion comic production, visual design, code review, or your own field.
- **Connect tools and workflows.** Connect tools through MCP, turn repeatable processes into Skills, and use Hooks to customize how tasks run.
- **Change the interface and source.** Choose a built-in theme, or modify the UI, tools, and runtime source to build your own version of OpenBitFun.

**You can ask OpenBitFun's Code Agent to modify and extend OpenBitFun itself.**

Learn more about [agent management](./docs/interactive-capabilities/capabilities/feature.agents.md), [Hooks and compatibility](./docs/features/agent-hooks.md), and the [product architecture](./docs/architecture/product-architecture.md).

## Built for sustained work

The Rust Agent Runtime manages session state, context, and tool execution. Persistent sessions, interruption recovery, long-term memory, and support for extended tasks help keep work moving. Context compression and cache reuse help control resource consumption over longer runs.

In this **DeepSWE v1.1** evaluation, OpenBitFun achieved:

- **GLM-5.3-Flash**: **64.6%** pass rate, **42.9 minutes** median runtime (P50).
- **DeepSeek-V4-Flash**: **56.6%** pass rate, **19.6 minutes** median runtime (P50).

![DeepSWE v1.1 comparison: pass rate, runtime P50, and token P50](./png/openbitfun-deepswe-v1.1.png)

## More to explore

**These are just some of OpenBitFun's features.** Explore more tools, workflows, and extensions as you put it to work on your own tasks.

![A selection of OpenBitFun's features](./png/openbitfun-feature-wall.jpg)

## Where we're headed

OpenBitFun is still evolving. Here are three directions we want to explore:

- **Lights-Out Factory**: Plan and design during the day, let tasks continue on a server, and come back the next morning to review the results.
- **Infinite Radius**: Extend from desktops and phones to wearables and embedded devices, so work can continue in more places.
- **App Evolution**: Enable more people to shape software, from personal tools to versions tailored to a profession or industry.

Getting there means making long-running tasks more reliable, the runtime more efficient, and the desktop experience smoother.

## Build with it. Help shape it.

**Share what you build, offer feedback, or contribute code to help shape OpenBitFun.**

Share your use cases and experience, contribute agents, Skills, or Mini Apps, or help improve the docs, interface, and runtime. Ideas and questions are welcome in this repository's Issues and Discussions. See the [contribution guide](./CONTRIBUTING.md) for the development workflow.

<details>
<summary>Download, setup, and running from source</summary>

Get the Windows, macOS, or Linux package from the [official download page](https://openbitfun.com/download). Install it, configure a model, and open a workspace to get started. See the [user guide](https://playbook.openbitfun.com) for usage instructions and [download verification](./docs/verify-downloads.md) for package signature checks.

**Migration note:** OpenBitFun 1.0.0 is not data-compatible with legacy 0.2.x releases. To migrate legacy data,
use the [OpenBitFun Data Tools](src/apps/data-tools/README.md), currently available
for stable releases 0.2.17–0.2.19.

To run from source, install [Node.js](https://nodejs.org/) 22.12+, [pnpm](https://pnpm.io/) 10.15.0, the [Rust toolchain](https://rustup.rs/), and the [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/). Clone the repository, then run:

```bash
pnpm install
pnpm run desktop:dev
```

Desktop development supports frontend hot reload and automatic Rust rebuilds. See the [CLI guide](./src/apps/cli/README.md) for the command-line workflow.

</details>

Core code is licensed under the [MIT License](./LICENSE). Third-party dependencies and assets retain their own licenses. Thanks to the open-source authors and contributors who make this work possible. To report a vulnerability, see the [security policy](./SECURITY.md).

## Star History

<a href="https://www.star-history.com/?repos=gcwing%2Fopenbitfun&amp;type=date&amp;legend=top-left">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=gcwing/openbitfun&amp;type=date&amp;legend=top-left&amp;theme=dark" />
    <img alt="OpenBitFun Star History Chart" src="https://api.star-history.com/chart?repos=gcwing/openbitfun&amp;type=date&amp;legend=top-left" />
  </picture>
</a>

### Native mobile development

Android, iOS and HarmonyOS source code and releases have moved to
[OpenBitFun-Mobile](https://github.com/openBitFun/OpenBitFun-Mobile).
The browser mobile-web client and Desktop/CLI/Relay host implementations remain in this repository.

