{"id":28263687,"url":"https://github.com/pskillen/meshflow-api","last_synced_at":"2026-05-26T19:01:08.936Z","repository":{"id":289227474,"uuid":"969759105","full_name":"pskillen/meshflow-api","owner":"pskillen","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-26T13:32:57.000Z","size":2160,"stargazers_count":0,"open_issues_count":36,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-26T13:33:07.997Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pskillen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-04-20T21:37:41.000Z","updated_at":"2026-05-25T17:21:22.000Z","dependencies_parsed_at":"2025-05-15T22:26:52.596Z","dependency_job_id":"7e40d818-0c16-4975-802e-446611a71e82","html_url":"https://github.com/pskillen/meshflow-api","commit_stats":null,"previous_names":["pskillen/meshflow-api"],"tags_count":50,"template":false,"template_full_name":null,"purl":"pkg:github/pskillen/meshflow-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pskillen%2Fmeshflow-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pskillen%2Fmeshflow-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pskillen%2Fmeshflow-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pskillen%2Fmeshflow-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pskillen","download_url":"https://codeload.github.com/pskillen/meshflow-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pskillen%2Fmeshflow-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33534563,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"ssl_error","status_checked_at":"2026-05-26T15:22:15.568Z","response_time":63,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":"2025-05-20T08:11:54.597Z","updated_at":"2026-05-26T19:01:08.914Z","avatar_url":"https://github.com/pskillen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meshflow API\n\nMeshflow is a distributed telemetry collection system designed for Meshtastic radio networks. It provides a secure,\nstructured backend to ingest, store, and analyze public packets broadcast across geographically distributed mesh nodes.\nThe system is intended to be self-hosted, Dockerized, and built using Django REST Framework with PostgreSQL as the\nbacking store.\n\n---\n\n## 🔧 Project Structure\n\nThis repository will contain the backend API for Meshflow, organized as a modular Django project with the following\napps:\n\n- **Nodes** – manages radios (Meshtastic nodes) and their API keys\n- **Constellations** – groups of nodes managed collectively\n- **Regions** – geographical groupings used to partition mesh data\n- **Packets** – ingestion and processing of raw mesh packets\n- **Users** – standard Django users, acting as SysOps in node context\n- **Common** – shared utilities, permissions, middleware, etc.\n\nRoot layout:\n\n```\nMeshflow/\n├── manage.py\n├── Meshflow/                # Django settings, urls, wsgi\n├── Nodes/\n├── Packets/\n├── Constellations/\n├── Regions/\n├── Users/\n└── Common/\n```\n\n---\n\n## 🚀 Components\n\n- **Meshflow API** – the Django-based backend (this project)\n- **Meshflow Relay** – lightweight local client running beside a Meshtastic node\n- **Meshflow Dashboard** – React-based frontend for visualizing and managing mesh activity\n\n---\n\n## 🌐 API Overview (planned)\n\nAll endpoints will be namespaced under `/api/v1/`.\n\n```\n/api/v1/\n├── auth/\n├── packets/ingest/           # POST endpoint for Meshflow Relay\n├── nodes/                    # Manage and list nodes\n├── nodes/\u003cid\u003e/apikeys/       # Rotate/manage node API keys\n├── constellations/           # Group nodes for SysOp management\n├── regions/                  # List regions, get stats\n├── stats/global/             # Public stats\n├── stats/my-nodes/           # SysOp-specific metrics\n```\n\n---\n\n## ⚙️ Tech Stack\n\n- Python 3.x\n- Django 4.x\n- Django REST Framework\n- PostgreSQL\n- Docker / Docker Compose\n\n---\n\n## 🛠️ Setup Instructions (TBD)\n\nThis project is under initial development. Once bootstrapped, the following will apply:\n\n```bash\n# Clone and enter repo\ncd Meshflow\n\n# Install dependencies\npip install -r requirements.txt\n\n# Run migrations\npython manage.py migrate \u0026\u0026 python manage.py run_deploy_tasks\n\n# Start development server\npython manage.py runserver\n```\n\nDocker setup will be included via `docker-compose.yml`.\n\n---\n\n## 🧭 Philosophy\n\nMeshflow is designed to be:\n\n- **Transparent** – SysOps and the public can see activity and trends\n- **Modular** – easy to extend, replace, or separate components\n- **Open** – friendly to community deployment and contribution\n\n---\n\n## 📌 Status\n\n\u003e 🧪 Currently pre-alpha. The core architecture and structure are being scaffolded.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskillen%2Fmeshflow-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpskillen%2Fmeshflow-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpskillen%2Fmeshflow-api/lists"}