BeeCount δΈ­ζ–‡

August 31, 2026 Β· View on GitHub

GitHub stars License Release Downloads Last commit Flutter

Your Data, Your Control β€” Open Source Accounting App

Sync via BeeCount Cloud (self-hosted) / iCloud / Supabase / WebDAV / S3


Download on App Store Get it on Google Play Self-host Web

🌐 Website Β· πŸ“– Docs Β· πŸ’ Donate Β· πŸ’¬ Telegram Β· πŸ“¦ APK Β· πŸš€ TestFlight


πŸ€– New: MCP support β€” pair with BeeCount Cloud to drive your ledger from any MCP client.


πŸ’‘ Why BeeCount

A lightweight, open-source, privacy-first personal finance and expense tracking app.

Traditional appsBeeCount
❌ Data on third-party servers, no auditβœ… Fully open-source, code auditable
❌ Privacy may be analyzed and exploitedβœ… Offline-first + self-hosted, developer can't access your data
❌ Service shutdown = data lossβœ… Data sovereignty, choose from 5 sync options
❌ Premium features behind paywallsβœ… Completely free (including AI / OCR / voice input)
❌ Ads / financial product recommendationsβœ… Zero ads / zero tracking / zero data collection

Platform support: πŸ€– Android 5.0+ Β· 🍎 iOS 15.5+ Β· 🌐 Web (built into BeeCount Cloud, see below)

πŸ“± HarmonyOS β€” Discontinued


🌟 Core Features

πŸ€– AI-Powered β€” AI assistant / OCR / voice / auto-capture from screenshots
  • AI Assistant β€” Natural language conversation, intent recognition, powered by Zhipu GLM-4
  • OCR Photo Capture β€” Dual engines (local TFLite + GLM cloud), recognizes Alipay/WeChat/UnionPay screenshots
  • Voice Input β€” Hold to speak, GLM models understand colloquial expressions
  • Auto Capture from Screenshots β€” Android accessibility service / iOS Shortcuts back-tap
πŸ“ Bookkeeping β€” multi-ledger / accounts / categories / budgets / recurring / tags / charts / import-export
  • Multi-ledger β€” Separate ledgers for life/work/investment, each with its own currency
  • Multiple accounts β€” Cash/card/credit, transfer auto-updates both balances
  • Two-tier categories β€” Parent-child hierarchy
  • Budgets β€” Total + category budgets, overspending alerts
  • Recurring transactions β€” Daily/weekly/monthly/yearly auto-records for fixed income/expenses
  • Tags β€” Multi-tag with color labels for flexible filtering
  • Charts β€” Monthly reports / category rankings / trends / annual report
  • Import/Export β€” CSV (Alipay/WeChat bills) + YAML config
🎨 Experience β€” dark mode / multi-language / home widgets / theming
  • Dark mode β€” Pure black + theme accent borders, OLED-friendly
  • Multi-language β€” official Simplified/Traditional Chinese & English, community-contributed Korean, with localized formatting
  • Home widgets β€” 6 types Γ— 12 variants (overview / net assets / quick add / budget / recent / dashboard), dark-mode, multi-language & theme-color aware, see the full lineup
  • Theme customization β€” Multiple primary colors

πŸ“Έ Screenshots

Add transaction AI OCR Analytics

Home Widgets

6 content types Γ— 12 variants β€” check your books and add records right from the home screen:

View the widget lineup (6 types Γ— 12 variants)
Home widget lineup: overview / net assets / quick add / budget / recent transactions / dashboard
More screenshots (9 themes / dark mode)

9 Core Themes

Home Cloud Service Analytics
AI Smart Logging Quick Entry Multi-Ledger
Color Tags Net Worth Settings

Dark Mode

Home dark Charts dark Profile dark AI chat dark

☁️ Sync Options

BeeCount offers 5 sync options. Your data, your control. See docs/cloud-setup_EN.md for full setup guides.

OptionBest ForHighlights
BeeCount CloudReal-time multi-device + self-hosted + multi-user co-writeOne-click Docker, sub-second sync, built-in Web, multi-user, shared ledgers
iCloudiOS-only usersZero config, native integration
SupabaseCross-platform without NASGenerous free tier, easy setup
WebDAVNAS usersLocal data, Synology/UGREEN/Nextcloud
S3 protocolFlexible cloud storageCloudflare R2/AWS S3/MinIO, large free tier

πŸ” Why self-host? Privacy first, cost control, data security, fully open-source. All sync code is auditable.


πŸ†• BeeCount Cloud (Self-hosted)

Sub-second multi-device sync + Web admin + multi-user isolation + AES-256 encrypted backup β€” Recommended for users with NAS / VPS / Docker.

Highlights

  • πŸ“± Real-time multi-device β€” Phone A makes a change, Phone B and Web see it within seconds (WebSocket)
  • 🌐 Built-in Web admin β€” One Docker image = server + web; open server URL to use
  • πŸ‘₯ Multi-user isolation β€” One server, many user accounts, each only sees their own data
  • 🀝 Shared ledgers β€” Owner generates an invite code; family / team join the same book. Owner / Editor roles, realtime sync, every transaction tagged with creator + last editor, plus member balance stats. iOS / Android / Web all supported.
  • πŸ” AES-256 encrypted backup β€” Multi-remote fan-out (R2 / S3 / WebDAV / B2), AES zip encryption β€” recoverable with standard tools even without the service

Deploy + Full Documentation

Full Docker Compose deployment, backup system, PWA, and ops details live in the Cloud repo:

πŸ‘‰ BeeCount-Cloud repo β€” One-click Docker deploy + full docs

Web Admin Preview

Web home
πŸ’° Home: income/expense, asset breakdown, category heatmap, trends β€” at a glance (dark mode)
More Web screenshots
Web transactions
πŸ“’ Transactions: keyword / category / account / date / tag multi-filter

Web devices
πŸ“± Online devices + backup archive management

πŸ› οΈ Development

Tech stack + quick start

Tech Stack

  • Flutter 3.27+ Β· Cross-platform UI framework
  • Riverpod Β· State management
  • Drift (SQLite) Β· Local database ORM
  • Supabase / Self-hosted BeeCount Cloud / WebDAV / S3 Β· Multi-option cloud sync

Quick Start

# Install dependencies
flutter pub get

# Code generation
dart run build_runner build --delete-conflicting-outputs

# Run app
flutter run --flavor dev

# Build release
flutter build apk --flavor prod --release

See docs/contributing/CONTRIBUTING.md for development conventions.


🀝 Contributing

All contributions welcome

Quick start: Fork β†’ create feature branch β†’ commit β†’ PR. See the full contributing guide for details.


🎨 Skins

Contribute a skin

"Theme color + skin = the header banner." Skins come in two kinds: code skins (CustomPainter drawing gradients / shapes, auto-following the theme color) and image skins (an SVG painted edge-to-edge with BoxFit.cover, optionally recolored to the theme color via themed: true).

Easiest path: copy example_skin.svg β†’ drop your SVG into assets/header_skins/ β†’ register one entry in lib/styles/header_skins.dart β†’ add an i18n name and run flutter gen-l10n.

Full spec (SVG requirements + theme recoloring + integration steps): assets/header_skins/README_EN.md.


πŸ’¬ FAQ

Common questions

Q: Can I use it without configuring cloud services? A: Absolutely! The app uses local storage by default. All features work normally. You can export CSV for backup anytime.

Q: Which sync option should I pick? A:

  • iOS single device β†’ iCloud (zero config)
  • Cross-platform + real-time multi-device β†’ BeeCount Cloud (self-hosted, recommended)
  • Cross-platform without NAS β†’ Supabase / S3
  • Have a NAS β†’ WebDAV

Q: How is data security ensured? A: Use your own server / Storage / Bucket. WebDAV and S3 should use HTTPS. BeeCount Cloud backups are AES-256 encrypted by default.

For more details, see docs/cloud-setup_EN.md or Issues.


BeeCount is completely free and open-source β€” no ads, no paid features. If you find it useful, buy the developer a coffee β˜• to support continued development.

How to Donate

PayPal

Alipay / WeChat QR codes
AlipayWeChat Pay
AlipayWeChat

USDT (TRC20): TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C Β·

Binance QR codeBinance

Cost Transparency

ItemAmount
Apple Developer Account renewalΒ₯688 / year
Lightweight cloud server (ICP filing)Β₯79 / year
DomainΒ₯80 / year
Google Play Developer Account (one-time)Β₯177
Annual recurring costΒ₯847 / year

Supporters

*Qiao Β₯12*Rui Β₯720fishdivinity Β₯100*Shao Β₯15*Ge Β₯6*Te Β₯15*Wen Β₯50Anonymous Β₯50birdnofoots Β₯10Charies Β₯10542474846 Β₯66JOHN-2025 Β₯30HowcanoeWang Β₯98

πŸ’‘ Already donated? Submit info to be displayed in the list.


πŸ“„ License

This project uses the Business Source License (BSL).

Use CaseLicense
βœ… Personal / learning / open-source contributionCompletely free
❌ Commercial useRequires paid license
What counts as commercial use
  • Providing this software as a commercial product or service to customers
  • Using it in a for-profit organization
  • Building commercial products on top of this software
  • Offering paid cloud services based on this software

For commercial licensing pricing and process, see COMMERCIAL_LICENSE.md or contact sunxiaoyes@outlook.com. See LICENSE_EN for details.


RepositoryDescription
BeeCount-CloudSelf-hosted sync server + Web admin (FastAPI + React)
BeeCount-WebsiteWebsite / docs repo
beecount-openharmonyHarmonyOS version (discontinued)
honeycombClaude Code plugin marketplace (skills/agents used for developing this project)

πŸ™ Acknowledgments

Thanks to Guhe Bake (Internet Pure Land) and Star Mochen for promoting this project.

Thanks to everyone who has contributed code, suggestions, or feedback to BeeCount!

For questions or suggestions, please raise an Issue or join the Discussions.

BeeCount 🐝 β€” Making accounting simple and secure