dandri/MeshChatX

Fork 0

mirror of https://git.quad4.io/RNS-Things/MeshChatX.git synced 2026-04-25 17:32:09 +00:00

Files

Ivan 9c025bd8c5 chore(version): update repository version

2026-04-15 02:27:31 -05:00

12 KiB

Raw Blame History

Reticulum MeshChatX

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

Un fork ampiamente modificato e ricco di funzionalita di Reticulum MeshChat di Liam Cottle.

Questo progetto e indipendente dal progetto originale Reticulum MeshChat e non e affiliato ad esso.

Sito web: meshchatx.com
Codice sorgente: git.quad4.io/RNS-Things/MeshChatX
Mirror ufficiale: github.com/Sudo-Ivan/MeshChatX — usato anche per le build Windows e macOS al momento.
Release: git.quad4.io/RNS-Things/MeshChatX/releases
Changelog: CHANGELOG.md
TODO: Boards

Modifiche importanti rispetto a Reticulum MeshChat

Usa LXST
Peewee ORM sostituito con SQL diretto
Axios sostituito con fetch nativo
Electron aggiornato
Wheel .whl con web server e asset frontend integrati per piu opzioni di deploy
i18n
PNPM e Poetry per le dipendenze

Warning

MeshChatX non garantisce la compatibilita dei dati con le versioni precedenti di Reticulum MeshChat. Eseguire un backup prima della migrazione o dei test.

Warning

I sistemi legacy non sono ancora completamente supportati. Requisiti minimi attuali: Python >=3.11 e Node >=24.

Requisiti

Python >=3.11 (da pyproject.toml)
Node.js >=24 (da package.json)
pnpm 10.32.1 (da package.json)
Poetry (utilizzato in Taskfile.yml e nei workflow CI)

task install
task lint:all
task test:all
task build:all

Metodi di installazione

Scegli il metodo in base all'ambiente e al formato del pacchetto.

Metodo	Include frontend	Architetture	Ideale per
Immagine Docker	Si	`linux/amd64`, `linux/arm64`	Avvio rapido su server Linux
Python wheel (`.whl`)	Si	Qualsiasi architettura supportata da Python	Installazione headless/web-server senza build Node
Linux AppImage	Si	`x64`, `arm64`	Uso desktop portatile
Pacchetto Debian (`.deb`)	Si	`x64`, `arm64`	Installazione Debian/Ubuntu
Pacchetto RPM (`.rpm`)	Si	Dipende dal CI	Fedora/RHEL/openSUSE
Da sorgente	Compilato localmente	Architettura host	Sviluppo e build personalizzati

Note:

Il workflow di release compila esplicitamente Linux x64 e arm64 AppImage + DEB.
RPM viene anche tentato e caricato quando prodotto con successo.

Avvio rapido: Docker

docker compose up -d

Il file compose predefinito mappa:

127.0.0.1:8000 sull'host -> porta 8000 del container
./meshchat-config -> /config per la persistenza

In caso di errori di permessi:

sudo chown -R 1000:1000 ./meshchat-config

Installazione da artefatti di release

1) Linux AppImage (x64/arm64)

Scaricare ReticulumMeshChatX-v<versione>-linux-<arch>.AppImage dalle release.
Rendere eseguibile e avviare:

chmod +x ./ReticulumMeshChatX-v*-linux-*.AppImage
./ReticulumMeshChatX-v*-linux-*.AppImage

2) Debian/Ubuntu `.deb` (x64/arm64)

Scaricare ReticulumMeshChatX-v<versione>-linux-<arch>.deb.
Installare:

sudo apt install ./ReticulumMeshChatX-v*-linux-*.deb

3) Sistemi RPM

Scaricare ReticulumMeshChatX-v<versione>-linux-<arch>.rpm se presente nella release.
Installare:

sudo rpm -Uvh ./ReticulumMeshChatX-v*-linux-*.rpm

4) Python wheel (`.whl`)

I wheel delle release includono gli asset web compilati.

pip install ./reticulum_meshchatx-*-py3-none-any.whl
meshchatx --headless

pipx e supportato:

pipx install ./reticulum_meshchatx-*-py3-none-any.whl

Esecuzione da sorgente (modalita web server)

Per sviluppo o build locali personalizzate.

git clone https://git.quad4.io/RNS-Things/MeshChatX.git
cd MeshChatX
corepack enable
pnpm install
pip install poetry
poetry install
pnpm run build-frontend
poetry run python -m meshchatx.meshchat --headless --host 127.0.0.1

Esecuzione in sandbox (Linux)

Per eseguire il binario nativo meshchatx (alias: meshchat) con isolamento aggiuntivo del filesystem, puoi usare Firejail o Bubblewrap (bwrap) mantenendo l'accesso di rete normale per Reticulum e l'interfaccia web. Esempi completi (pip/pipx, Poetry, note sulla seriale USB) sono in:

docs/meshchatx_linux_sandbox.md

La stessa pagina compare nell'elenco Documentazione in-app (documentazione MeshChatX) quando viene servita dai file meshchatx-docs inclusi o sincronizzati.

Compilazione pacchetti desktop da sorgente

Gli script sono definiti in package.json e Taskfile.yml.

Linux x64 AppImage + DEB

pnpm run dist:linux-x64

Linux arm64 AppImage + DEB

pnpm run dist:linux-arm64

RPM

pnpm run dist:rpm

Oppure tramite Task:

task dist:fe:rpm

Supporto architetture

Docker: amd64, arm64
Linux AppImage: x64, arm64
Linux DEB: x64, arm64
Windows: x64, arm64 (script di build disponibili)
macOS: script di build disponibili (arm64, universal) per ambienti di build locali
Android: progetto e workflow CI presenti nel repository

Android

Configurazione

Argomento	Variabile d'ambiente	Predefinito	Descrizione
`--host`	`MESHCHAT_HOST`	`127.0.0.1`	Indirizzo di bind del web server
`--port`	`MESHCHAT_PORT`	`8000`	Porta del web server
`--no-https`	`MESHCHAT_NO_HTTPS`	`false`	Disattiva HTTPS
`--ssl-cert` / `--ssl-key`	`MESHCHAT_SSL_CERT` / `MESHCHAT_SSL_KEY`	(nessuno)	Percorsi PEM certificato e chiave; impostare entrambi. Sostituisce i certificati auto-generati sotto l'identita nella directory `ssl/`.
`--rns-log-level`	`MESHCHAT_RNS_LOG_LEVEL`	(nessuno)	Livello di log Reticulum (RNS): `none`, `critical`, `error`, `warning`, `notice`, `verbose`, `debug`, `extreme` o numerico. La CLI ha priorita sulla variabile d'ambiente se entrambe sono impostate.
`--headless`	`MESHCHAT_HEADLESS`	`false`	Non aprire il browser automaticamente
`--auth`	`MESHCHAT_AUTH`	`false`	Attiva autenticazione base
`--storage-dir`	`MESHCHAT_STORAGE_DIR`	`./storage`	Directory dei dati
`--public-dir`	`MESHCHAT_PUBLIC_DIR`	auto/bundle	Directory dei file frontend (per installazioni senza asset inclusi)

Branch

Branch	Scopo
`master`	Release stabili. Solo codice pronto per la produzione.
`dev`	Sviluppo attivo. Potrebbe contenere modifiche instabili o incomplete.

Sviluppo

Attivita comuni da Taskfile.yml:

task install
task lint:all
task test:all
task build:all

Scorciatoie Makefile:

Comando	Descrizione
`make install`	Installa dipendenze pnpm e poetry
`make run`	Esegue MeshChatX tramite poetry
`make build`	Compila il frontend
`make lint`	Esegue eslint e ruff
`make test`	Test frontend e backend
`make clean`	Rimuove artefatti di build e node_modules

Versioning

Versione attuale nel repository: 4.5.0.

La fonte della versione JavaScript/Electron e package.json.
meshchatx/src/version.py e sincronizzato da package.json con:

pnpm run version:sync

Per release coerenti, allineare i campi di versione dove richiesto (package.json, pyproject.toml, meshchatx/__init__.py).

Sicurezza

SECURITY.md
Controlli di integrita integrati e HTTPS/WSS predefiniti nell'app
Workflow di scansione CI in .gitea/workflows/

Aggiungere una lingua

Il rilevamento delle lingue e automatico. Per aggiungere una nuova lingua basta un singolo file JSON:

Generare un modello vuoto da en.json:

python scripts/generate_locale_template.py

Scrive locales.json con ogni chiave impostata a stringa vuota.

Rinominare e spostare nella cartella delle lingue:

mv locales.json meshchatx/src/frontend/locales/xx.json

Impostare _languageName all'inizio del file con il nome nativo della lingua (es. "Espanol", "Francais"). Viene mostrato nel selettore lingua.
Tradurre tutti i valori rimanenti.
Verificare la corrispondenza delle chiavi: pnpm test -- tests/frontend/i18n.test.js --run

Nessun altra modifica al codice e necessaria. App, selettore lingua e test scoprono le lingue in meshchatx/src/frontend/locales/ al momento della build.

Crediti

Liam Cottle - Reticulum MeshChat originale
RFnexus - Parser Micron (JavaScript)
markqvist - Reticulum, LXMF, LXST

12 KiB Raw Blame History