TNT-Likely/BeeCount

TNT-Likely/BeeCount has 2,742 GitHub stars and 374 forks. GitHot measured +7 stars in 24 hours and +54 in 7 days. Last checked 2026-11-05 18:40 UTC. Last push 2026-10-30.

How these counts are measured

Local-first bookkeeping for iOS/Android/Web · Self-hosted cloud + iCloud/WebDAV/S3 sync · AI capture · MCP | 本地优先的跨端记账 · 自建云 + iCloud/WebDAV/S3 同步 · AI 记账 · MCP

2,742 stars 374 forks +7 in 24h

Measured star growth

in 24h: +7
in 7 days: +54
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README_EN.md

Original

BeeCount 中文

Release Downloads Last commit

Your Data, Your Control — Open Source Accounting App

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

🌐 Website · 📖 Docs · 💝 Donate · 🤝 Business · 💬 Telegram · 📦 APK · 🚀 TestFlight

🤖 New: MCP support — pair with BeeCount Cloud to drive your ledger from any MCP client.

❤️ Sponsor

CrazyToken provides APIs for Claude, GPT, Gemini, Kimi, GLM, DeepSeek, Qwen, Grok, and other leading models to power conversational bookkeeping, receipt image recognition, and income & expense organization.
💰 As low as 0.05×: save up to 99% with transparent token-level billing.
✨ Official native access: no quality loss, no model substitution, no context compression—preserving the native model experience.
⚡ Fast & stable, no concurrency caps: smoother bookkeeping conversations and receipt recognition.
🎁 $20 signup gift for new users: register via the exclusive link to receive trial credits, plus top-up bonuses and 1-on-1 remote setup assistance to help connect your model API.

🤝 Want your project here? Business inquiry

💡 Why BeeCount

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

Traditional apps	BeeCount
❌ 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 6.0+ (GitHub APK) / Android 7.0+ (Google Play) · 🍎 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 — 8 types and 14 variants (overview / net assets / quick add / budget / recent / dashboard / Spending Rhythm / Record Bee Trail), dark-mode, multi-language & theme-color aware, see the full lineup
Theme customization — Multiple primary colors

📸 Screenshots

Home Widgets

8 content types and 14 variants — check your books and add records right from the home screen:

View the widget lineup (8 types, 14 variants)

Home widget lineup: overview / net assets / quick add / budget / recent transactions / dashboard / Spending Rhythm / Record Bee Trail

More screenshots (core features / dark mode)

9 Core Themes

Dark Mode

☁️ Sync Options

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

Option	Best For	Highlights
BeeCount Cloud	Real-time multi-device + self-hosted + multi-user co-write	One-click Docker, sub-second sync, built-in Web, multi-user, shared ledgers
iCloud	iOS-only users	Zero config, native integration
Supabase	Cross-platform without NAS	Generous free tier, easy setup
WebDAV	NAS users	Local data, Synology/UGREEN/Nextcloud
S3 protocol	Flexible cloud storage	Cloudflare 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

_{💰 Complete dashboard: income/expense, asset breakdown, category heatmap, trends and rankings (light mode)}

More Web screenshots

Web transactions with complete pagination

_{📒 Transactions: keyword / category / account / date / tag multi-filter}

_{💳 Account balances, asset composition and liabilities}

Full receipt, related transaction and preview controls

_{🧾 Complete receipt preview, related transactions, zoom and original file download}

🛠️ 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

🐛 Report a bug
💡 Feature request
💻 Code · 🌍 Translation · 📝 Docs · 🎨 Designer recruitment

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.

💝 Donate

BeeCount and BeeCount Cloud are maintained by the same developer. If these projects help you, consider buying the developer a coffee ☕ to support continued development.

How to Donate

Alipay / WeChat QR codes

Alipay	WeChat Pay

USDT

Binance Pay — scan with the Binance app:

On-chain USDT (TRC20) — scan with any TRON wallet:

Address: TKBV69B2AoU67p3vDhnJUbMJtZ1DxuUF5C

Supporters

¥720

¥150

¥98

¥66

¥50

¥30

¥15

¥12

¥10

¥6

¥5

💡 Already donated? Submit info to appear in the supporter list.

🤝 Business Inquiries

For commercial licensing, deployment assistance, custom development, or partnerships, email us with a brief description of your needs and use case.

📧 [email protected]

📄 License

This project uses the Business Source License (BSL).

Use Case	License
✅ Personal / learning / open-source contribution	Completely free
❌ Commercial use	Requires 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 [email protected]. See LICENSE_EN for details.

📦 Related Repositories

Repository	Description
BeeCount-Cloud	Self-hosted sync server + Web admin (FastAPI + React)
BeeCount-Website	Website / docs repo
beecount-openharmony	HarmonyOS version (discontinued)
honeycomb	Claude 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