Skip to content
ZakarialabibPublic

About

A local-first Ai Email solution for small and medium businesses

Topics

Resources

Contributing

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

517 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SMEMaster

The local-first business workspace for email, CRM, campaigns, calendar, tasks & automation

Built for people who are tired of renting their business data back from the cloud.

CI License Docs


One-liner: A desktop-first, local-first workspace for small and medium businesses β€” email, contacts, campaigns, tasks, calendar, automation, and security in one app, on your machine, under your control.

Why this exists: Small business owners shouldn't have to duct-tape six SaaS tools together to handle one customer conversation. Your machine, your business.


What it does

Feature What it actually does
πŸ“§ Email Multi-account inbox, Gmail API + IMAP/SMTP, labels, search, drafts, offline-safe actions
πŸ‘₯ CRM Contacts, groups, tags, dynamic segments, activity context, scoring
πŸ“£ Campaigns Campaign builder, mail merge, A/B, analytics, outreach workflows
πŸ“… Calendar Calendar views and sync-oriented event management
βœ… Tasks Priorities, due dates, recurrence, multiple views, linked workflow support
βš™οΈ Automation Trigger/action rules and automation builder flows
✍️ Composer Signatures, attachments, aliases, undo-send, scheduled send
πŸ” PGP Sequoia OpenPGP integration for encrypted messages
πŸ—„οΈ Vault Attachment vault and file workflows
πŸ“‘ Deliverability DNS, blacklist, bounce, and sender-health tooling
πŸ€– AI Provider-based assistants for categorization, writing, summaries, inbox queries
πŸŽ™οΈ Offline speech On-device STT + TTS via sherpa-onnx β€” no API key, no network, audio never leaves the machine
🌍 i18n English, French, Arabic, Japanese, Italian β€” including RTL for Arabic

Platforms & availability

SMEMaster targets desktop (Windows Β· Linux Β· macOS) and Android, built with Tauri v2 + React 19 + Rust.

State Platforms
🚧 In active development Windows, Linux, macOS (desktop) · Android (mobile)
πŸ“¦ Buildable from source Windows installer (NSIS) Β· Linux Β· macOS Β· Android APK/AAB
πŸ—ΊοΈ On the roadmap Signed store releases, broader multi-device sync, plugin ecosystem

Builds are produced from source today; signed public installers are part of the v1.0 hardening pass (code signing certificates are the remaining blocker). Watch GitHub Releases.


Status

Stage: v1.0.0-rc β€” feature-complete and compiling, pre-release hardening in progress.

Recently shipped

  • πŸŽ™οΈ Offline speech (STT + TTS) β€” on-device via sherpa-onnx; STT RTF 0.033 at 99.8% match, TTS RTF 0.573, both verified end-to-end against the shipped binary
  • βš™οΈ AI settings reorganized β€” Text Generation / Voice / Local Models, with a model catalog and resumable downloads
  • πŸ”Œ Sidecar lifecycle control β€” Start/Stop/Refresh in Settings β†’ Voice, with honest engine-state reporting
  • πŸ› Startup panic fixed β€” EventBus was read before it was managed, so the app could not start at all
  • πŸ› Sidecar Stop fixed β€” the watchdog restarted the process ~2 s after Stop, so the UI said "stopped" while it kept running
  • πŸ—οΈ Reproducible sidecar build β€” scripts/build-sidecar.sh wired into every build; CI no longer ships a speech-less sidecar
  • 🧰 Tauri MCP bridge β€” dev-only; lets an agent drive the running app (this is what found the two bugs above)
  • 🎨 Settings UI overhaul β€” all 24 settings tabs beautified with premium card layout, stats rows, step-by-step setup wizards
  • 🌐 RTL + i18n cleanup β€” 164 physical-direction CSS violations fixed across 48 files; 1,685 [TODO] translation prefixes cleared in fr/ar/ja/it locales
  • πŸš€ Onboarding rework β€” standalone page after splash; auto-skips if email accounts or demo data already exist
  • πŸ€– AI RAG UI β€” local semantic search & RAG feature complete
  • 🏷️ account_id β†’ company_id rename β€” 30+ files across the full stack, zero TS/Rust errors
  • πŸ“± Mobile UX Overhaul β€” all 5 phases 100% implemented
  • πŸ—οΈ Data layer evolution β€” dead-code eliminated, offline-availability + optimistic email actions
  • 🟒 Shared component library β€” 6 reusable UI primitives + 5 stability hooks/utils
  • 🟒 Typed UI event bus (uiBus) β€” replaced stringly-typed window.dispatchEvent("smemaster-*") with a fully-typed emitter

In progress

  • Manual stability tests (panic injection, WAL recovery, watchdog restart)
  • Code signing certificates + auto-updater pubkey
  • 7-day dogfooding + public beta run
  • Plugin architecture & store releases

Not yet verified β€” stated plainly rather than implied by a green check:

  • TTS intelligibility β€” machine-checked as non-silent audio of the correct rate/duration; whether it sounds right is a human judgement
  • Non-English STT β€” only English (Zipformer Small) is measured; other locales are model availability, not quality
  • Live-call TTS β€” RTF 0.573 + STT 0.033 approaches real time; marginal for a live call

Full picture β†’ docs/STATUS.md.


Project structure

smeMaster/
β”œβ”€β”€ docs/                 # Architecture, features, roadmap, release, user guides
β”‚   β”œβ”€β”€ 00-INDEX.md       # Docs hub (start here)
β”‚   β”œβ”€β”€ 01-ARCHITECTURE/  # System & data-model design
β”‚   β”œβ”€β”€ 02-BACKEND/       # Rust & Tauri internals
β”‚   β”œβ”€β”€ 03-FRONTEND/      # React/TS patterns & guides
β”‚   β”œβ”€β”€ 04-FEATURES/      # Per-feature specs
β”‚   β”œβ”€β”€ 05-DEVELOPMENT/   # Contributor setup
β”‚   β”œβ”€β”€ 06-ROADMAP/       # Master plan
β”‚   └── user-guide/       # End-user docs
β”œβ”€β”€ src/                  # React 19 + TypeScript frontend
β”œβ”€β”€ src-tauri/            # Rust + Tauri backend/runtime
β”œβ”€β”€ scripts/              # Release & maintenance scripts
└── package.json

Tech stack: React 19 + TypeScript 7 (UI) Β· Rust + Tauri v2 (native runtime) Β· SQLite + WAL (persistence) Β· Zustand (state) Β· sherpa-onnx (on-device speech) Β· typed IPC contracts Β· event-driven cache Β· built with bun and Vite 8 (Rolldown).


Quick start for developers

Requirements

  • Bun 1.4.2+ β€” the package manager and script runner (lockfile is bun.lock; there is no package-lock.json)
  • Rust 1.77.2+
  • Tauri v2 prerequisites

Windows note: make sure C:\msys64\ucrt64\bin is on your PATH.

⚠️ Building with offline speech needs ~10 GB free. The sidecar links onnxruntime and lancedb; a full build plus the Tauri app can exceed 20 GB of target/.

Run locally

git clone https://github.com/Zakarialabib/smeMaster.git
cd smeMaster
bun install
bun run tauri:dev

Useful commands

Command Purpose
bun run dev Start the Vite frontend only
bun run test Unit tests (vitest --project unit, jsdom)
bun run typecheck TypeScript 7 typecheck (tsc --noEmit)
bun run lint ESLint, zero warnings tolerated
bun run tauri:build Build the desktop app (builds the sidecar first)
bun run windows:build Windows NSIS installer
bun run android Android development flow
bun run sidecar:build Build ml-sidecar with offline speech
bun run tauri:dev:mcp Dev build with the Tauri MCP bridge (port 9223)

bun, not npm. npm install will not honour bun.lock. If you need a one-off binary, use bunx instead of npx.

Offline speech (STT / TTS)

The speech engine is an optional offline-speech feature of the ml-sidecar crate, built and installed by scripts/build-sidecar.sh:

bun run sidecar:build:release     # β†’ src-tauri/binaries/ml-sidecar-<triple>.exe

tauri:build, windows:build and windows:portable all run this first, so the bundled app can't ship without it.

⚠️ Use --release. A debug build of this crate fails to link with LNK1318: Unexpected PDB error β€” a PDB/filesystem limit on a ~234-object link, not a code error.

⚠️ Without offline-speech the sidecar compiles and runs but answers unknown method to every speech call, which looks like a broken feature rather than a wrong binary. See docs/02-BACKEND/20-offline-stt-and-audio-summarization.md.


Documentation

Start at docs/00-INDEX.md. Key entry points:

Area Start here
Architecture Overview Β· Backend structure Β· Data model
Backend IMAP engine Β· SMTP Β· PGP Β· OAuth Β· Key management
Frontend State Β· Service layer Β· Reuse patterns Β· Shared components
Features Email Β· CRM Β· Campaigns Β· AI RAG Β· PGP
Development Quickstart Β· Testing Β· Design system
Roadmap Status Β· Master plan
User guide Getting started Β· Account setup Β· PGP setup Β· Backup & restore
Changelog Release Notes

Contributing

This is an indie, solo-founded project and contributions are genuinely welcome:

  1. Report bugs through Issues
  2. Propose ideas in Discussions
  3. Open PRs with tests where appropriate
  4. Improve docs when you spot drift or ambiguity

Preferred conventions: Conventional Commits, TypeScript strict mode, targeted tests for meaningful behavior changes.


License & Privacy

Apache 2.0 Β· Privacy Policy


SMEMaster β€” From lead to loyalty, all in one place.

Star Β· Bug Β· Discuss

About

A local-first Ai Email solution for small and medium businesses

Topics

Resources

Contributing

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages