Reticulum MeshChatX
Русский | Deutsch | Italiano | 中文 | 日本語
Initially MeshChatX was a fork of Reticulum MeshChat by Liam Cottle. It has evolved to be very much different and focused on modern software development principles. It may be buggy due to many changes and adapted to make it more maintainable and end goal of improving stability.
There are many changes from MeshChat: LXST, RRC relay chat, a dedicated Map that is offline ready, raw SQL instead of an ORM, native fetch instead of Axios, latest stable Electron, wheels with bundled frontend, i18n, pnpm 12+ with supply chain security.
MeshChatX is also focused on security and privacy, including usage of native OS sandboxing like AppContainer for windows and Landlock for linux.
AI Disclaimer: LLMs may be used to assist with development and maintaining the project, but all code is reviewed by humans and follows best practices.
- Website: meshchatx.com
- Source: github.com/Quad4-Software/MeshChatX
- Mirror: CodeFloe
- PyPI: reticulum-meshchatx
- Changelog: CHANGELOG.md
- Donate: donate.md
- LXMF:
f489752fbef161c64d65e385a4e9fc74
rngit NomadNet Node: 132f67e79d9b24aad014e93015fb858f:/page/index.mu
Install/Usage Methods
There are many ways you can use MeshChatX.
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
Container Images: quad4io/meshchatx (Docker Hub) and ghcr.io/quad4-software/meshchatx. Hardened and extra tags are in Installation.
PyPI (pip, pipx, uv)
pip install reticulum-meshchatx
# or
pipx install reticulum-meshchatx
# or
uv pip 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
# or taskfile
task install && task build && task run
# Or 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, Flatpak, Electron, and Android: Installation and Building.
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 |
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).
1 maintainer
Metadata
1 maintainer
Release files for reticulum-meshchatx 4.10.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| reticulum_meshchatx-4.10.4.tar.gz | 21.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| reticulum_meshchatx-4.10.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 43.9 MB
Release files / reticulum_meshchatx-4.10.4.tar.gz
| Download URL | reticulum_meshchatx-4.10.4.tar.gz |
|---|---|
| Size | 21.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bd6297646d494e2c9167b556629dfa4d61a157a8c1d5ab0e04b934776ea77277
|
|
BLAKE2b-256 checksum How to use checksums |
d5860b880f1cd30e81d282f603634f3ad2fbc6b1444a32cfcc97cc1170bca588
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency logRelease files / reticulum_meshchatx-4.10.4-py3-none-any.whl
| Download URL | reticulum_meshchatx-4.10.4-py3-none-any.whl |
|---|---|
| Size | 22.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
30f2da7c64fa898f02572267498e7a085a5aef65370cef52deda68cbb30ee758
|
|
BLAKE2b-256 checksum How to use checksums |
2a92d6af7208699949cf4143eb71855661c9f5ac4a63fc5a189584b7ab310e12
|
| Upload date | |
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2026.
Transparency log
