Reticulum MeshChatX

Русский | Deutsch | Italiano | 中文 | 日本語

Fork of Reticulum MeshChat by Liam Cottle. MeshChatX adds LXST voice calls, RRC relay chat, Nomad map overlays, plugins, raw SQLite (no Peewee), and Electron 41 desktop builds. Independent from upstream. Not affiliated with it.

• Website: meshchatx.com
• Source: github.com/Quad4-Software/MeshChatX
• Mirror: lavaforge.org/Reticulum-Things/MeshChatX
• PyPI: reticulum-meshchatx
• Changelog: CHANGELOG.md
• Donate: donate.md
• LXMF: f489752fbef161c64d65e385a4e9fc74
• Umbrel: apps.umbrel.com/app/meshchatx

rngit NomadNet Node: 132f67e79d9b24aad014e93015fb858f:/page/index.mu

Install

Requirements for source builds: Python 3.11+, Node.js 24+, pnpm 11.1.2, UV. Web UI needs Safari 16.4, Chrome 111, or Firefox 128+. PyPI and Docker ship the built frontend (no Node on the runtime host).

Docker

docker compose -f docker/docker-compose.yml up -d

docker run -d --name reticulum-meshchatx \
  -p 127.0.0.1:8000:8000 \
  -v meshchatx-config:/config \
  ghcr.io/quad4-software/meshchatx:latest

Images: quad4io/meshchatx (Docker Hub) and ghcr.io/quad4-software/meshchatx. Hardened and extra tags are in Installation.

PyPI (pip, pipx, uv)

Package: reticulum-meshchatx

pip install reticulum-meshchatx
# or
pipx install reticulum-meshchatx
# or
uv tool install reticulum-meshchatx

meshchatx --headless --host 127.0.0.1

meshchat is the same entry point. Release wheels from GitHub also work: pip install ./reticulum_meshchatx-*-py3-none-any.whl.

From source (git clone, make, task)

HTTPS:

git clone https://github.com/Quad4-Software/MeshChatX.git
cd MeshChatX

Over Reticulum (rngit / git-remote-rns):

git clone rns://06a54b505bb67b25ef3f8097e8001edc/public/MeshChatX
cd MeshChatX

Then install and run with either Make or Task (same targets):

make install && make build && make run

task install && task build && task run

Or step through UV / pnpm yourself:

corepack enable
pnpm install --frozen-lockfile
uv sync --group dev
pnpm run build-frontend
uv run python -m meshchatx.meshchat --headless --host 127.0.0.1

AppImage, deb, rpm, Electron, and Android: Installation and Building.

Current version is 4.8.6.

Docs

Guide	Covers
Getting started	First-day flow
Installation	Docker details, packages, CLI flags
Building	Offline builds, packaging, Android APK
Development	task/make, versioning, locales
Identities and security	Backups, corruption recovery, wipe
Platform guides	Pi, Termux, Quest, Linux sandbox

Changes from Reticulum MeshChat

LXST calls, RRC relay chat, MBTiles map plus remote KMZ/KML/GeoJSON overlays, raw SQL instead of Peewee, native fetch instead of Axios, Electron 41 (Node 24), wheels with built frontend, i18n, pnpm and UV.

Security, license, credits

• SECURITY.md · LEGAL.md · donate.md
• Project-owned code is 0BSD. Upstream MeshChat portions remain MIT. Full text: LICENSE.
• Credits: Liam Cottle (original MeshChat), RFnexus (micron parser JS), markqvist (Reticulum, LXMF, LXST).