Skip to content

GCWing/BitFun

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

350 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

中文 | English

BitFun

AI assistant with personality and memory

Hand over the work, keep the life

AI Agent workspace for coding and knowledge work

GitHub release Website License: MIT Platform


Introduction

In the age of AI, true human-machine collaboration is not just a ChatBox, but a partner that understands you, works with you, keeps evolving, and gets things done anytime, anywhere. That is where BitFun begins.

BitFun is a next-generation AI assistant with built-in Code Agent and Cowork Agent. It has memory, personality, and the ability to evolve over time. You can remotely control the desktop through mobile QR pairing or Telegram / Feishu bots, send instructions, and watch each execution step in real time while the Agent keeps working in the background.

Built with Rust + TypeScript for an ultra-lightweight, fluid, cross-platform experience.

BitFun


Dual Modes

BitFun provides two modes for different kinds of work:

  • Assistant Mode: warmer, preference-aware, and backed by long-term memory. Best for ongoing collaboration, such as maintaining a project or preserving your writing and design style.
  • Professional Mode: token-efficient, execution-first, and context-clean. Best for short, focused tasks like fixing a bug or updating a small feature.

Remote Control

With QR pairing, your phone instantly becomes a remote command center for the desktop Agent. Send one message and the desktop AI starts working right away.

The desktop generates a QR code, and the mobile browser opens the remote interface after scanning it, with no app installation required.

Besides mobile QR pairing, BitFun also supports Telegram / Feishu bots for remote instructions and real-time progress tracking.

Feature Description
QR Pairing Scan a QR code generated by the desktop, complete key exchange, and bind a long-lived connection
Full Control View sessions, switch modes, send instructions, and control the desktop workflow remotely
Real-time Streaming Every Agent step and tool call can be viewed live on your phone

Agent System

Agent Role Core Capabilities
Personal Assistant (Beta) Your dedicated AI companion Long-term memory and personality settings; can orchestrate Code / Cowork / custom Agents on demand, and continuously evolve
Code Agent Coding assistant Four modes: Agentic (autonomous read / edit / run / verify) / Plan (plan first, then execute) / Debug (instrumentation to root cause) / Review (repository-aware code review)
Cowork Agent Knowledge work assistant Built-in PDF / DOCX / XLSX / PPTX handling, and can fetch and extend suitable capability packages from the Skill marketplace
Custom Agent Domain specialist Quickly define a domain-specific Agent with Markdown

Ecosystem

It keeps growing.

Mini Apps emerge from conversations, Skills evolve in the community, and Agents improve through collaboration.

Layer Description
Mini Apps Generate runnable interfaces from a prompt and package them into desktop apps with one click
Skill Marketplace Install community capability packs so Agents can learn new skills quickly
MCP Protocol Connect external tools and resources to extend Agent capabilities beyond the local system
Custom Agents Define roles, memory, and capability boundaries with Markdown
ACP Protocol (WIP) A structured multi-Agent communication standard for interoperating with mainstream AI tools

Platform Support

The project is built with Rust + TypeScript for cross-platform reuse, keeping your Agent available wherever you work.

Form Factor Supported Platforms Status
Desktop Windows, macOS ✅ Supported (Tauri)
Remote Control Mobile browser, Telegram, Feishu ✅ Supported

Quick Start

Download and Use

Download the latest desktop installer from Releases. After installation, configure your model and start using BitFun.

CLI, Server, and native mobile apps are still in planning or development. Desktop and remote control are already supported.

Build from Source

Make sure you have the following prerequisites installed:

# Install dependencies
pnpm install

# Run desktop app in development mode
pnpm run desktop:dev

# Build desktop app
pnpm run desktop:build

For more details, see the Chinese Contributing Guide.


Contributing

We welcome great ideas and code contributions. We are maximally accepting of AI-generated code. Please submit PRs to the dev branch first; we will periodically review and sync to the main branch.

Key contribution areas we focus on:

  1. Contributing good ideas and creativity in features, interaction, and visual design via Issues
  2. Optimizing the Agent system and overall quality
  3. Improving system stability and foundational capabilities
  4. Expanding the ecosystem, including Skills, MCP, LSP plugins, and support for vertical development scenarios

Disclaimer

  1. This project is built in spare time for exploring and researching next-generation human-machine collaboration, not for commercial profit.
  2. 97%+ of this project was built with Vibe Coding. Feedback on code issues is also welcome, and refactoring or optimization through AI is encouraged.
  3. This project depends on and references many open-source projects. Thanks to all open-source authors. If your rights are affected, please contact us for rectification.

The world is being rewritten, and this time, we are all holding the pen.

About

BitFun is a next-generation AI assistant with built-in Code Agent and Cowork Agent. It has memory, personality, and the ability to evolve over time. You can remotely control the desktop through mobile QR pairing or Telegram / Feishu bots, send instructions, and watch each execution step in real time while the Agent keeps working in the background.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors