Skip to main content

Python API & client shell for talking to Meshtastic devices

Project description

Meshtastic Python

codecov PyPI - Downloads CI CLA assistant Fiscal Contributors Vercel

Overview

A Python client for use with Meshtastic devices. This small library (and example application) provides an easy API for sending and receiving messages over mesh radios. It also provides access to any of the operations/data available in the device user interface or the Android application. Events are delivered using a publish-subscribe model, and you can subscribe to only the message types you are interested in.

Getting Started Guide

Documentation/API Reference

Call for Contributors

This library and CLI has gone without a consistent maintainer for a while, and there's many improvements that could be made. We're all volunteers here and help is extremely appreciated, whether in implementing your own needs or helping maintain the library and CLI in general.

If you're interested in contributing but don't have specific things you'd like to work on, look at the roadmap below!

Roadmap

This should always be considered a list in progress and flux -- inclusion doesn't guarantee implementation, and exclusion doesn't mean something's not wanted. GitHub issues are a great place to discuss ideas.

  • Types
    • type annotations throughout the codebase
    • mypy running in CI to type-check new code
  • async-friendliness
  • CLI completeness & consistency
    • the CLI should support all features of the firmware
    • there should be a consistent output format available for shell scripting
  • CLI input validation & documentation
    • what arguments and options are compatible & incompatible with one another?
    • can the options be restructured in a way that is more self-documenting?
    • pubsub events should be documented clearly
  • helpers for third-party code
    • it should be easy to write a script that supports similar options to the CLI so many tools support the same ways of connecting to nodes
  • interactive client
  • data storage & processing
    • there should be a standardized way of recording packets for later use, debugging, etc.
    • a sqlite database schema and tools for writing to it may be a good starting point
    • enable maps, charts, visualizations

Stats

Alt

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meshtastic-2.3.2.tar.gz (77.0 kB view details)

Uploaded Source

Built Distribution

meshtastic-2.3.2-py3-none-any.whl (92.3 kB view details)

Uploaded Python 3

File details

Details for the file meshtastic-2.3.2.tar.gz.

File metadata

  • Download URL: meshtastic-2.3.2.tar.gz
  • Upload date:
  • Size: 77.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.19

File hashes

Hashes for meshtastic-2.3.2.tar.gz
Algorithm Hash digest
SHA256 d9578b5bd88f533e583821b845b2ed115a826a2593820158bf182fd8c8ada232
MD5 8ae0f9bf78e8a07be29c6ba3b4e73fa4
BLAKE2b-256 e2cae82f78c191fa2963572d90ed384203b6f4859d76d55a473889d5ebdf6f4a

See more details on using hashes here.

File details

Details for the file meshtastic-2.3.2-py3-none-any.whl.

File metadata

  • Download URL: meshtastic-2.3.2-py3-none-any.whl
  • Upload date:
  • Size: 92.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.9.19

File hashes

Hashes for meshtastic-2.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 89696e983c8c37e8e4d85a75c4c180686dacb439098af055deb54e2b2eae4859
MD5 eb7591056c02ed26ba02db2e7bb42a12
BLAKE2b-256 827b6c068538c6f1e80e223ec30930ed711111fa2d9eb76195207117881b2b42

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page