Skip to content

chuk-development/chuk_chat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

601 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Chuk Chat Logo

Chuk Chat

Private AI That Actually Belongs to You

A simple monthly subscription, full control, no data mining.
Chat, write, code, research — powered entirely by transparent open-weight models.

Website · Web App · Docs · Downloads

License: BSL 1.1 Flutter 3.24+ Platforms


Why Chuk Chat?

We use only open-weight models — no black boxes and no silent data collection. You know exactly what runs your AI.

  • Clear monthly pricing — One fee covers platform access and AI credits. No hidden costs.
  • Open-weight only — DeepSeek, Llama, Mistral, Qwen, and more via OpenRouter. No closed-source models.
  • Privacy first — Encrypted chats, no tracking, no profiling. Built like a tool, not a marketing funnel.
  • Your data, your control — We store nothing you don't want. Fully deletable. Fully controllable. Fully yours.

Features

Core

  • End-to-End Encryption — All chats encrypted client-side with AES-256-GCM before being stored or synced
  • Cross-Platform — Android, iOS, Linux, macOS, Windows, and Web
  • Real-Time Streaming — Watch AI responses as they're generated, with streaming preserved across chat switches
  • File Attachments — Share images, PDFs, and documents with AI
  • Offline Support — Access your chat history without a connection, with automatic network recovery and cache preloading

AI Tools

  • Tool Calling — Built-in tool system with registry, executor, and per-tool settings. AI can call tools and display results inline
  • AI Image Generation — Generate and edit images directly in chat (including Hunyuan v3 Instruct via edit-image tool)
  • Interactive Maps — AI responses with <map> blocks render inline maps with markers, popups, and route polylines (OSRM)
  • Calculator, Weather, Stocks, QR Codes, Notes, Web Search — Expanding set of built-in tool handlers
  • Multi-Pass Tool Call Rendering — Interleaved content blocks show text and tool calls in correct chronological order with collapsible UI

Account & Privacy

  • Multi-Step Account Deletion — GDPR-compliant three-step deletion flow with password confirmation
  • In-App Update Checks — Automatic version checking against GitHub Releases with platform-specific download links (APK, DEB, AppImage, DMG, EXE)

UI & UX

  • Theme Customization — Colors, backgrounds, dark/light mode, visual effects
  • Redesigned Reasoning UI — Expandable accent-tinted cards for model reasoning and tool call details
  • Mobile Three-Pill Input — Redesigned mobile input bar with separate attachment, text, and action pills
  • Audio Visualizer — Gradient glow waveform with exponential scaling for voice recording
  • Unified Image Preview — Consistent image viewer across desktop and mobile with copy-to-clipboard support
  • Debug Chat Copy — Copy full chat contents (including reasoning, tool calls, model info) to clipboard for debugging

Security & Privacy

  • Client-side encryption — Messages are encrypted on your device before leaving it
  • Zero-knowledge architecture — We cannot read your chats, even if the server is compromised
  • Certificate pinning — Protection against MITM attacks, including WebSocket connections
  • Image validation — Magic-byte verification on uploaded images
  • No logging in production — All debug logs are disabled in release builds

If you lose your password, all your chats are permanently lost. There is no recovery mechanism by design — this ensures maximum privacy. Choose a strong password and store it safely.

What is encrypted

Data Storage
All chat messages Encrypted locally + synced to cloud (still encrypted)
Chat titles & metadata Encrypted
Starred chat status Encrypted
Your encryption key Stored in device keychain/keystore — never leaves your device

For detailed security information, see SECURITY.md.

Pricing

€20/month — all models, all platforms. Includes €16 in monthly AI credits; €4 covers infrastructure and platform access.

See chuk.chat/en/pricing for details.

Development

Prerequisites

  • Flutter SDK 3.24+ (includes Dart 3.9.2+)
  • Supabase project (supabase.com)

Platform-specific: Android Studio (Android), Xcode (iOS/macOS), Visual Studio 2022 (Windows).

Setup

git clone https://github.com/chuk-development/chuk_chat.git
cd chuk_chat

cp .env.example .env
# Edit .env with your Supabase credentials

flutter pub get
./run.sh linux    # or: android, android-x64, android-vm [avd_name], windows, macos, ios, web

Build

# Quick release build (loads credentials from .env)
flutter build apk --release \
  --dart-define-from-file=.env \
  --dart-define=PLATFORM_MOBILE=true

# Full release (all platforms)
./scripts/build-release.sh all

Documentation

Full developer and architecture documentation is available at docs.chuk.chat.

See also the docs/ folder for build instructions, architecture, database schema, and more.

Contributing

  1. Fork the repo
  2. Create a feature branch
  3. Run flutter analyze and dart format .
  4. Open a Pull Request

See CONTRIBUTING.md for details.

Tech Stack

Component Technology
Framework Flutter (Dart)
Backend Supabase
Encryption AES-256-GCM with PBKDF2 key derivation
AI Models OpenRouter
Hosting Dokploy + Cloudflare

License

Business Source License 1.1 — free for non-production use. Converts to GPL v3 after 3 years per release.

Links

About

Cross-platform encrypted chat app with AI integration — built with Flutter, Supabase & E2E encryption

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors