{"id":28906729,"url":"https://github.com/leslieleung/meshboi","last_synced_at":"2026-02-23T01:06:16.122Z","repository":{"id":272102513,"uuid":"915537118","full_name":"LeslieLeung/meshboi","owner":"LeslieLeung","description":"A bot for interacting with Meshtastic devices.","archived":false,"fork":false,"pushed_at":"2025-01-12T05:34:05.000Z","size":0,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-12T06:21:32.103Z","etag":null,"topics":["bot","meshtastic","meshtastic-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LeslieLeung.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-12T05:27:07.000Z","updated_at":"2025-01-12T05:49:38.000Z","dependencies_parsed_at":"2025-01-12T06:32:10.051Z","dependency_job_id":null,"html_url":"https://github.com/LeslieLeung/meshboi","commit_stats":null,"previous_names":["leslieleung/meshboi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LeslieLeung/meshboi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeslieLeung%2Fmeshboi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeslieLeung%2Fmeshboi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeslieLeung%2Fmeshboi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeslieLeung%2Fmeshboi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LeslieLeung","download_url":"https://codeload.github.com/LeslieLeung/meshboi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LeslieLeung%2Fmeshboi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261143163,"owners_count":23115677,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","meshtastic","meshtastic-python"],"created_at":"2025-06-21T15:09:40.668Z","updated_at":"2026-02-23T01:06:16.112Z","avatar_url":"https://github.com/LeslieLeung.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meshboi\n\nEnglish | [简体中文](README_zh.md)\n\nA bot for interacting with [Meshtastic](https://meshtastic.org/) devices. Meshboi provides a bot platform to communicate with Meshtastic nodes, supporting both serial and WiFi connections.\n\n## Features\n\n- Support for both serial and WiFi connections\n- Built-in commands:\n  - `#test` - Test the bot connection\n  - `#help` - Show available commands\n  - `#ping` - Ping the bot (includes signal information)\n- Runs on Docker\n\n## Installation\n\n### Prerequisites\n\n- Python 3.13\n- Poetry (Python package manager)\n- A Meshtastic device\n\n### Using Poetry\n\n```bash\n# Clone the repository\ngit clone https://github.com/LeslieLeung/meshboi\ncd meshboi\n\n# Install dependencies\npoetry install\n```\n\n### Using Docker\n\n```bash\n# Run with serial connection (replace /dev/ttyUSB0 with your device path)\ndocker run --device=/dev/ttyUSB0 leslieleung/meshboi --connection-type serial --serial-port /dev/ttyUSB0\n\n# Run with WiFi connection\ndocker run leslieleung/meshboi --connection-type wifi --hostname your-device-ip\n```\n\n## Usage\n\n### Command Line Options\n\n```bash\npython main.py [--connection-type {serial,wifi}] [--hostname HOSTNAME] [--serial-port SERIAL_PORT]\n```\n\n- `--connection-type`: Choose between \"serial\" or \"wifi\" connection (default: serial)\n- `--hostname`: Required for WiFi connection, specify the Meshtastic device's IP address\n- `--serial-port`: Optional for serial connection, specify the device path (auto-discovers if not specified)\n\n### Available Commands\n\n- `#test`, `#測試`, `#测试` - Test the bot connection\n- `#help`, `#幫助`, `#帮助` - Show available commands\n- `#ping` - Ping the bot (returns signal information)\n\n### Environment Variables\n\n- `DEBUG`: Set to \"true\" for debug-level logging (default: false)\n\n## Development\n\nThe project uses Poetry for dependency management. To set up a development environment:\n\n```bash\n# Install development dependencies\npoetry install\n\n# Run the bot\npoetry run python main.py\n```\n\n## Credits\n\n- [meshtastic/python](https://github.com/meshtastic/python)\n- [hayschan/outdoorMeshBot](https://github.com/hayschan/outdoorMeshBot)\n- [meshcn.net](https://meshcn.net/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleslieleung%2Fmeshboi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleslieleung%2Fmeshboi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleslieleung%2Fmeshboi/lists"}