{"id":48673491,"url":"https://github.com/antonygiomarxdev/maverick","last_synced_at":"2026-04-17T20:02:36.915Z","repository":{"id":350144935,"uuid":"1205240113","full_name":"antonygiomarxdev/maverick","owner":"antonygiomarxdev","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-17T19:19:31.000Z","size":772,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T19:33:48.995Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/antonygiomarxdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-08T19:18:07.000Z","updated_at":"2026-04-17T19:19:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/antonygiomarxdev/maverick","commit_stats":null,"previous_names":["antonygiomarxdev/maverick"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/antonygiomarxdev/maverick","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonygiomarxdev%2Fmaverick","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonygiomarxdev%2Fmaverick/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonygiomarxdev%2Fmaverick/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonygiomarxdev%2Fmaverick/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/antonygiomarxdev","download_url":"https://codeload.github.com/antonygiomarxdev/maverick/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/antonygiomarxdev%2Fmaverick/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31943882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-17T17:29:20.459Z","status":"ssl_error","status_checked_at":"2026-04-17T17:28:47.801Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-04-10T13:05:23.647Z","updated_at":"2026-04-17T20:02:36.909Z","avatar_url":"https://github.com/antonygiomarxdev.png","language":"Rust","funding_links":[],"categories":["Satellite Communication"],"sub_categories":["SMPP / SMS Gateways"],"readme":"# Maverick\n\n**LoRaWAN. Offline. Always.**\n\n*Self-contained LoRaWAN gateway + network server for edge deployments where connectivity is unreliable or nonexistent.*\n\n[Install](#install) · [Quick Start](#quick-start) · [Why Maverick](#why-maverick) · [Extensions](#extensions) · [Community](#community)\n\n---\n\n## What is this?\n\nMaverick is a **gateway and LoRaWAN network server in one binary**. It runs on a Raspberry Pi in the middle of a cornfield, reads packets from a SX1302/SX1303 radio over SPI, stores everything in local SQLite — and keeps working even when the satellite link goes down for three days.\n\nNo cloud required. No external dependencies. Your data is on that device until you decide otherwise.\n\n```\n┌──────────────────────────────────────────────────────────┐\n│  Raspberry Pi (edge)                                      │\n│  ┌────────────────┐     ┌─────────────────────────────┐  │\n│  │   SX1303 HAT    │────▶│        maverick-edge        │  │\n│  │   (radio)       │     │  gateway + LNS + SQLite    │  │\n│  └────────────────┘     └─────────────────────────────┘  │\n│                                      │                   │\n│                          Extensions: TUI, HTTP, MQTT, AI│\n└──────────────────────────────────────────────────────────┘\n                                      │\n                                      │ when connected\n                                      ▼\n                               Maverick Cloud (future)\n```\n\n## Why Maverick\n\n| | Traditional LNS | Maverick |\n|---|---|---|\n| Requires internet | Yes | No |\n| Runs on Raspberry Pi | Needs gateway + server | Single binary |\n| Data if offline | Lost | Persists locally |\n| Extension crash | May affect LNS | Isolated |\n| Setup complexity | High | `curl ... | bash` |\n\nWorks with existing packet forwarders too (UDP/GWMP), if you already have gateway hardware.\n\n## Quick Start\n\n### Install (one command)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/antonygiomarxdev/maverick/main/scripts/install-linux.sh | bash\n```\n\nOr manual:\n\n```bash\n# Download from releases\nwget https://github.com/antonygiomarxdev/maverick/releases/latest/download/maverick-edge-linux-armv7.tar.gz\ntar -xzf maverick-edge-linux-armv7.tar.gz\nsudo mv maverick-edge /usr/local/bin/\n\n# Run setup (interactive)\nmaverick-edge setup\n```\n\n### Verify\n\n```bash\nmaverick-edge health\nmaverick-edge status\n```\n\n### Configure\n\nEdit `/etc/maverick/lns-config.toml` to add your devices and region. Then:\n\n```bash\nmaverick-edge radio ingest-loop\n```\n\nThat's it. Uplinks go to SQLite. Connect a dashboard extension when you're ready.\n\n## Extensions\n\nEverything is optional. Default install is just `maverick-edge` — nothing else.\n\n| Extension | When you need it |\n|-----------|------------------|\n| [`maverick-tui`](https://github.com/antonygiomarxdev/maverick/tree/main/crates/maverick-extension-tui) | Terminal console for device management |\n| [`maverick-dashboard`](https://github.com/antonygiomarxdev/maverick) (future) | Web UI for visualization |\n| [`maverick-http`](https://github.com/antonygiomarxdev/maverick) (future) | Forward uplinks via HTTP webhooks |\n| [`maverick-mqtt`](https://github.com/antonygiomarxdev/maverick) (future) | Publish to MQTT broker |\n| [`maverick-ai`](https://github.com/antonygiomarxdev/maverick) (future) | Anomaly detection, AI analytics |\n\nExtensions are **separate processes**. If one crashes, `maverick-edge` keeps running.\n\n## Architecture\n\n```\nmaverick-edge\n┌────────────────────────────────────────────────────────────┐\n│  Radio SPI  │  SQLite  │  CLI  │  Extension IPC           │\n│  (SX1302/3) │ (local)  │       │  (HTTP, Unix socket)     │\n└────────────────────────────────────────────────────────────┘\n       │                                      │\n       ▼                                      ▼\n  LoRa Frames                          Extensions\n  (uplinks ↓                           (optional)\n   downlinks ↑)\n```\n\n## Status\n\n**Public beta** — v0.x. Core ingest path works. Extensions are being built.\n\nRoadmap: [ROADMAP.md](ROADMAP.md)\n\n## Install Options\n\n| Method | Use case |\n|--------|----------|\n| [`install.sh`](scripts/install-linux.sh) | Production deployments |\n| [Docker](docker-compose.yml) | Try it locally |\n| [Source build](#build-from-source) | Development |\n\n### Build from source\n\n```bash\ngit clone https://github.com/antonygiomarxdev/maverick\ncd maverick\ncargo build --release -p maverick-runtime-edge\n./target/release/maverick-edge --version\n```\n\n### Docker (local testing)\n\n```bash\ndocker compose up\n```\n\n## Community\n\n- **Issues**: [GitHub Issues](https://github.com/antonygiomarxdev/maverick/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/antonygiomarxdev/maverick/discussions)\n- **Contributing**: [CONTRIBUTING.md](CONTRIBUTING.md)\n\nContributions welcome: core, extensions, hardware compatibility, docs.\n\n## Related\n\n| Project | How it relates |\n|---------|----------------|\n| [ChirpStack](https://www.chirpstack.io/) | LNS, requires PostgreSQL + MQTT + internet |\n| [The Things Stack](https://www.thethingsnetwork.org/docs/lns/) | LNS, cloud-first |\n| [Helium](https://www.helium.com/) | Decentralized wireless, depends on hotspot network |\n| **Maverick** | Offline-first, local, self-contained |\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonygiomarxdev%2Fmaverick","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fantonygiomarxdev%2Fmaverick","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fantonygiomarxdev%2Fmaverick/lists"}