You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
19
27
20
-
In the age of AI, true human–machine collaboration isn't just a ChatBox — it's a partner that knows you, accompanies you, and gets things done for you anywhere, anytime. That's where BitFun's exploration begins.
28
+
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.
21
29
22
-
## What Is BitFun
30
+
Built with **Rust + TypeScript** for an ultra-lightweight, fluid, cross-platform experience.
23
31
24
-
BitFun is a next-generation Agent system built around the idea of **"AI assistants with personality and memory"**.
32
+
25
33
26
-
Every user has their own Agent assistant — one that remembers your habits and preferences, carries a unique personality, and keeps growing over time. On top of this assistant, BitFun ships with two built-in capabilities: **Code Agent** (coding assistant) and **Cowork Agent** (knowledge work assistant), along with a unified extension mechanism to define additional Agent roles as needed.
34
+
---
27
35
28
-
Your assistant isn't confined to the desktop — it can be reached through multiple channels, such as Telegram, WhatsApp, and other social platforms, letting you issue instructions anytime, anywhere. Tasks keep running in the background, and you check in or give feedback whenever convenient.
36
+
## Dual Modes
29
37
30
-
Built with **Rust + TypeScript**for an ultra-lightweight, fluid, cross-platform experience.
38
+
BitFun provides two modes for different kinds of work:
31
39
32
-
40
+
-**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.
41
+
-**Professional Mode**: token-efficient, execution-first, and context-clean. Best for short, focused tasks like fixing a bug or updating a small feature.
33
42
34
-
### Agent System
43
+
---
35
44
36
-
| Agent | Role | Core Capabilities |
37
-
|---|---|---|
38
-
|**Personal Assistant (WIP🚧)** (default) | Your dedicated AI companion | Long-term memory, personality settings, cross-scenario orchestration, continuous growth |
|**Custom Agent**| Domain specialist | Quickly define a domain-specific Agent with Markdown |
45
+
## Remote Control
42
46
43
-
### Code Agent Working Modes
47
+
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.
44
48
45
-
Code Agent is built for software development, offering multiple modes that cover the full cycle from day-to-day coding to deep debugging, with deep integration into MCP, Skills, and Rules:
49
+
The desktop generates a QR code, and the mobile browser opens the remote interface after scanning it, with no app installation required.
46
50
47
-
| Mode | Scenario | Characteristics |
48
-
|------|----------|-----------------|
49
-
|**Agentic**| Day-to-day coding | Conversation-driven; AI autonomously reads, edits, runs, and verifies. |
50
-
|**Plan**| Complex tasks | Plan first, then execute; align on critical changes upfront. |
|**Review**| Code review | Review code based on key repository conventions. |
51
+
Besides mobile QR pairing, BitFun also supports Telegram / Feishu bots for remote instructions and real-time progress tracking.
53
52
54
-
### Cowork Agent Workflow
53
+
| Feature | Description |
54
+
|---|---|
55
+
|**QR Pairing**| Scan a QR code generated by the desktop, complete key exchange, and bind a long-lived connection |
56
+
|**Full Control**| View sessions, switch modes, send instructions, and control the desktop workflow remotely |
57
+
|**Real-time Streaming**| Every Agent step and tool call can be viewed live on your phone |
55
58
56
-
Cowork Agent is designed for everyday work, following a "clarify first, execute next, stay trackable" collaboration principle, with built-in office Skills and access to the Skill marketplace:
59
+
##Agent System
57
60
58
-
|Skill|Trigger| Core Capabilities |
61
+
|Agent|Role| Core Capabilities |
59
62
|---|---|---|
60
-
|**PDF**| Working with .pdf files | Read/extract text & tables, merge/split/rotate, watermark, fill forms, encrypt/decrypt, OCR scanned PDFs |
61
-
|**DOCX**| Create or edit Word documents | Create/edit .docx, styles/TOC/headers & footers, image insertion, comments & tracked changes |
62
-
|**XLSX**| Working with spreadsheets | Create/analyze .xlsx/.csv, formulas & formatting, financial model standards (color coding, formula validation) |
|**agent-browser**| Browser interaction needed | Browser automation: open pages, click/fill forms, screenshot, scrape data, web app testing |
65
-
|**skill-creator**| Creating a custom Skill | Guides authoring new Skills to extend the Agent's domain-specific capabilities |
66
-
|**find-skills**| Looking for ready-made capabilities | Discover and install community-contributed reusable Skills from the Skill marketplace |
63
+
|**Personal Assistant** (Beta) | Your dedicated AI companion | Long-term memory and personality settings; can orchestrate Code / Cowork / custom Agents on demand, and continuously evolve |
64
+
|**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) |
65
+
|**Cowork Agent**| Knowledge work assistant | Built-in PDF / DOCX / XLSX / PPTX handling, and can fetch and extend suitable capability packages from the Skill marketplace |
66
+
|**Custom Agent**| Domain specialist | Quickly define a domain-specific Agent with Markdown |
67
67
68
68
---
69
69
70
-
### Extensibility
70
+
##Ecosystem
71
71
72
-
-**MCP Protocol**: Extend with external tools and resources via MCP servers; supports MCP Apps.
73
-
-**Skills**: Markdown/script-based capability packages that teach the Agent specific tasks (auto-reads Cursor, Claude Code, Codex configs).
74
-
-**Agent Customization**: Quickly define a specialized Agent's personality, memory scope, and capabilities with Markdown.
75
-
-**Rules**: Project/global-level convention injection; auto-reads Cursor and other mainstream tool configs.
76
-
-**Hooks (WIP🚧)**: Inject deterministic automation logic at key task milestones.
72
+
> It keeps growing.
73
+
74
+
Mini Apps emerge from conversations, Skills evolve in the community, and Agents improve through collaboration.
75
+
76
+
| Layer | Description |
77
+
|---|---|
78
+
|**Mini Apps**| Generate runnable interfaces from a prompt and package them into desktop apps with one click |
79
+
|**Skill Marketplace**| Install community capability packs so Agents can learn new skills quickly |
80
+
|**MCP Protocol**| Connect external tools and resources to extend Agent capabilities beyond the local system |
81
+
|**Custom Agents**| Define roles, memory, and capability boundaries with Markdown |
82
+
|**ACP Protocol (WIP)**| A structured multi-Agent communication standard for interoperating with mainstream AI tools |
77
83
78
84
---
79
85
86
+
## Platform Support
87
+
88
+
The project is built with Rust + TypeScript for cross-platform reuse, keeping your Agent available wherever you work.
|**Remote Control**| Mobile browser, Telegram, Feishu | ✅ Supported |
94
+
95
+
---
80
96
81
97
## Quick Start
82
98
83
-
### Use Directly
99
+
### Download and Use
84
100
85
-
Download the latest installer for the desktop app from [Release](https://github.com/GCWing/BitFun/releases). After installation, configure your model and you're ready to go.
101
+
Download the latest desktop installer from [Releases](https://github.com/GCWing/BitFun/releases). After installation, configure your model and start using BitFun.
86
102
87
-
Other form factors are currently only specification drafts and not yet developed. If needed, please build from source.
103
+
> CLI, Server, and native mobile apps are still in planning or development. Desktop and remote control are already supported.
88
104
89
105
### Build from Source
90
106
@@ -106,38 +122,31 @@ pnpm run desktop:dev
106
122
pnpm run desktop:build
107
123
```
108
124
109
-
For more details, see the [Contributing Guide](./CONTRIBUTING.md).
110
-
111
-
## Platform Support
112
-
113
-
The project uses a Rust + TypeScript tech stack, supporting cross-platform and multi-form-factor reuse — keeping your Agent assistant always online and reachable everywhere.
|**CLI**| Windows, macOS, Linux | 🚧 In Development |
119
-
|**Server**| - | 🚧 In Development |
120
-
|**Mobile** (Native App) | iOS, Android | 🚧 In Development |
121
-
|**Social Platform Integration**| Telegram, WhatsApp, Discord, etc. | 🚧 In Development |
122
-
125
+
For more details, see the [Chinese Contributing Guide](./CONTRIBUTING_CN.md).
123
126
127
+
---
124
128
125
129
## Contributing
126
-
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.
130
+
131
+
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.
127
132
128
133
Key contribution areas we focus on:
129
-
1. Contributing good ideas/creativity (features, interactions, visuals, etc.), submit issues
130
-
2. Optimizing the Agent system and its effectiveness
134
+
1. Contributing good ideas and creativity in features, interaction, and visual design via Issues
135
+
2. Optimizing the Agent system and overall quality
131
136
3. Improving system stability and foundational capabilities
132
-
4. Expanding the ecosystem (Skills, MCP, LSP plugins, or better support for specific vertical development scenarios)
137
+
4. Expanding the ecosystem, including Skills, MCP, LSP plugins, and support for vertical development scenarios
133
138
139
+
---
134
140
135
141
## Disclaimer
136
-
1. This project is built in spare time for exploring and researching next-generation human–machine collaborative interaction, not for commercial profit.
137
-
2. 97%+ of this project was built with Vibe Coding. Feedback on code issues is also welcome—refactoring and optimization can be done via AI.
142
+
143
+
1. This project is built in spare time for exploring and researching next-generation human-machine collaboration, not for commercial profit.
144
+
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.
138
145
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.**
139
146
140
147
---
141
148
<divalign="center">
142
-
The world is being rewritten—this time, we are all holding the pen.
149
+
150
+
The world is being rewritten, and this time, we are all holding the pen.
0 commit comments