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.9.

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).

Metadata

Release files for reticulum-meshchatx 4.8.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reticulum-meshchatx 4.8.9
File	Size	Uploaded
reticulum_meshchatx-4.8.9.tar.gz	18.1 MB	Sep 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for reticulum-meshchatx 4.8.9
File	Interpreter	ABI	Platform	Reset
reticulum_meshchatx-4.8.9-py3-none-any.whl 18.5 MB Sep 9, 2026	Python 3	none	any	Details

Total release size: 36.6 MB

Release files / reticulum_meshchatx-4.8.9.tar.gz

Download URL	reticulum_meshchatx-4.8.9.tar.gz
Size	18.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`c17e2b500cf60f112c33881fd27b2047dd9ae93cb4398d6a224db4f08da0370c`
BLAKE2b-256 checksum How to use checksums	`668c22054943f51c6ba78f06da5f06ef9fd1ef3bb6b5bb8dbdb962c7a723dfe5`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Quad4-Software/MeshChatX
Publishing commit: github.com/Quad4-Software/MeshChatX/tree/10071f446036894c422763bd4ed97ae20f3663bd

Workflow

Publishing configuration: github.com/Quad4-Software/MeshChatX/blob/10071f446036894c422763bd4ed97ae20f3663bd/.github/workflows/pypi.yml
Publishing logs: github.com/Quad4-Software/MeshChatX/actions/runs/34338837074/attempts/1

Artifact

Subject: reticulum_meshchatx-4.8.9.tar.gz
SHA-256 checksum: c17e2b500cf60f112c33881fd27b2047dd9ae93cb4398d6a224db4f08da0370c Verifying attestations

Release files / reticulum_meshchatx-4.8.9-py3-none-any.whl

Download URL	reticulum_meshchatx-4.8.9-py3-none-any.whl
Size	18.5 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`58dbdfd5709435ece132a32493e97dc9c90135e848de92be64477e1a9b5eabf6`
BLAKE2b-256 checksum How to use checksums	`f4a0d97abebfab6e3d4b7812bcc6e4fab573f259b9b6b413299d649b1cc13d96`
Upload date	Sep 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Quad4-Software/MeshChatX
Publishing commit: github.com/Quad4-Software/MeshChatX/tree/10071f446036894c422763bd4ed97ae20f3663bd

Workflow

Publishing configuration: github.com/Quad4-Software/MeshChatX/blob/10071f446036894c422763bd4ed97ae20f3663bd/.github/workflows/pypi.yml
Publishing logs: github.com/Quad4-Software/MeshChatX/actions/runs/34338837074/attempts/1

Artifact

Subject: reticulum_meshchatx-4.8.9-py3-none-any.whl
SHA-256 checksum: 58dbdfd5709435ece132a32493e97dc9c90135e848de92be64477e1a9b5eabf6 Verifying attestations