Release v0.3.4 Rust _bitchat_core MIT License

Encrypted mesh chat for terminal environments.

Decentralized, encrypted peer-to-peer messaging over Bluetooth LE and local networks, built with Python and accelerated by Rust. Operates with mutual Noise XX encryption, zero central servers, zero accounts, and zero telemetry.

Quick Install on Windows (WinGet)
winget install bitchat-rustpy
BitChat Active Terminal Chat View
Verified BitChat Active ChatView & Broadcast Dispatch over LAN Mesh Vector Textual Capture
Zero Central Servers
Direct peer-to-peer radio and local subnet links. No cloud intermediary.
Noise XX Handshake
Mutual authentication and forward-secret session keys in volatile RAM.
Rust Native Acceleration
High-throughput framing, CRC32, routing, and deduplication via PyO3.
Zero Telemetry
Audited local-only storage. No analytics, tracking, or marketing pings.

Engineered for autonomous local communication

Every feature listed here is grounded in the verified codebase of release v0.3.4. We clearly distinguish implemented capabilities from roadmap goals.

VERIFIED v0.3.4

Bluetooth Low Energy (BLE)

Full peripheral advertising and central scanning. Connects nodes within radio range without requiring existing network infrastructure or internet connectivity.

Linux BlueZ D-Bus • Windows WinRT API
VERIFIED v0.3.4

Local Area Network (LAN)

Automatic subnet peer discovery via UDP broadcast sockets and high-throughput length-prefixed TCP streaming channels across local Wi-Fi or Ethernet.

UDP Port 41234 • TCP Port 41235
VERIFIED v0.3.4

Noise XX Cryptography

Mutual peer authentication with ephemeral X25519 key exchange, ChaCha20-Poly1305 authenticated encryption, and BLAKE2s hashing. Session keys exist only in RAM.

Forward Secrecy • Replay Protected
VERIFIED v0.3.4

Rust Extension Core

Compiled native Rust module (_bitchat_core) providing wire-speed packet framing, CRC32 verification, store-and-forward routing, and bounded replay caches.

PyO3 ABI • Maturin Build Pipeline
VERIFIED v0.3.4

Textual Terminal TUI

Terminal-native interface featuring reactive peer sidebars, multi-channel tabs, command execution with prefix boundaries, and real-time radio telemetry.

Keyboard Accessible • Low Resource
VERIFIED v0.3.4

Reliable Lifecycle Management

Comprehensive multi-stage uninstallation system via bitchat --uninstall, Windows Add/Remove integration, and optional user data scrubbing.

Atomic Inno Uninstaller • Zero Lingering Traces

How BitChat operates without central infrastructure

BitChat integrates asynchronous Python networking with native compiled Rust primitives to establish resilient, encrypted local mesh networks.

STEP 01 Autonomous Peer Discovery

Nodes continuously advertise and listen across dual channels: BLE GATT service UUID F47B5E2D... and UDP port 41234 on the local network. No external directory server or STUN/TURN server is ever queried.

STEP 02 Mutual Noise XX Handshake

When two nodes establish a transport connection, they perform a 3-way mutual authentication handshake. Ephemeral keys generate symmetric session keys that remain strictly in volatile RAM and are destroyed upon disconnect.

STEP 03 Framing & CRC32 Verification

All packets pass through the Rust NativeStreamFramer with magic byte prefix BC\x01\x00, strict length boundaries, and CRC32 payload verification, eliminating malformed frames before Python processing.

STEP 04 Mesh Routing & Replay Mitigation

Multi-hop packets are routed through NativePacketRouter with configurable TTL decrements. A memory-bounded LRU deduplication cache discards replayed packets and prevents routing loops.

BitChat Hybrid Layered Architecture
Hybrid Python/Rust Architecture & Physical Transport Separation

Verified Textual Terminal Interface

Direct vector screen captures generated from running BitChat instances. High-contrast typography, reactive sidebars, and real-time telemetry.

Active Chat View in Terminal
Active Mesh Chat & Message Dispatch
Channel broadcasting (#public), timestamped logging, peer fingerprints, and isolated slash command input field.
Discovered Peer Grid in Terminal
Reactive Peer Grid & Routing Telemetry
Shows nearby nodes, radio transports (BLE/LAN), peer IDs, Ed25519 fingerprints, and live signal quality.
Command Help and Keybindings in Terminal
Command Reference & Keybindings (/help)
Integrated help modal with strict token boundary validation, keyboard shortcuts, and transport management options.
Subsystem Telemetry and Diagnostic Report in Terminal
Hardware Telemetry & Diagnostics (/configure)
Real-time status of host adapter, BlueZ/WinRT peripheral and central roles, and UDP/TCP socket bindings.

Verified release packages & support tiers

We provide official release binaries for verified platforms. We do not advertise packages that do not exist.

Platform Package Format Architecture Release Version Distribution Status Action
Windows 10 / 11 Native Desktop Installer Inno Setup (.exe) x64 0.3.4 Official Release Asset Download →
Linux (Debian / Ubuntu) System Package Debian (.deb) amd64 (x86_64) 0.3.4 Official Release Asset Download →
Linux Universal Self-Contained Executable AppImage (.AppImage) x86_64 0.3.4 Official Release Asset Download →
Python 3.12+ (Windows, Linux & macOS) Precompiled ABI3 Wheel Python Wheel (.whl) win_amd64 / linux_x86_64 / macosx_arm64 0.3.4 Official Release Asset Download →
macOS (Apple Silicon & Intel) Apple Silicon Wheel & Source Build (No .dmg/.pkg or BLE Peripheral yet) .whl (arm64) / uv source arm64 & x86_64 0.3.4 arm64 Wheel + Source Download / Guide →

Ready to communicate without intermediaries?

Download BitChat RustPy v0.3.4 or inspect the open-source code on GitHub.

Get BitChat RustPy 0.3.4 Read Documentation