{"id":30039297,"url":"https://github.com/bdr-pro/petabyte","last_synced_at":"2026-02-09T03:03:22.080Z","repository":{"id":307980911,"uuid":"1031257728","full_name":"BDR-Pro/petabyte","owner":"BDR-Pro","description":"petabyte cloud code!","archived":false,"fork":false,"pushed_at":"2025-08-03T11:15:57.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-03T13:07:09.612Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BDR-Pro.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,"zenodo":null}},"created_at":"2025-08-03T11:08:08.000Z","updated_at":"2025-08-03T11:16:00.000Z","dependencies_parsed_at":"2025-08-03T13:07:14.856Z","dependency_job_id":"2598415b-84c6-47ef-8ceb-310a5d573b5d","html_url":"https://github.com/BDR-Pro/petabyte","commit_stats":null,"previous_names":["bdr-pro/petabyte"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/BDR-Pro/petabyte","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2Fpetabyte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2Fpetabyte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2Fpetabyte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2Fpetabyte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BDR-Pro","download_url":"https://codeload.github.com/BDR-Pro/petabyte/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2Fpetabyte/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269185738,"owners_count":24374627,"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","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-08-07T01:41:22.602Z","updated_at":"2026-02-09T03:03:17.058Z","avatar_url":"https://github.com/BDR-Pro.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# petabyte\npetabyte cloud code!\n\nThis repository documents the relationship between the two core components of the **petabyte** decentralized cloud platform:\n\n- [`lumaris_agent`](https://github.com/BDR-Pro/lumaris_agent)\n- [`lumaris_api`](https://github.com/BDR-Pro/lumaris_api)\n\n## 🌐 Website \n\n[Visit the Landing Page](https://52101422ef55413ca04c4499cc498285-main.projects.builder.my/)\n\n## 🔧 What is Lumaris?\n\n**Lumaris** is a decentralized marketplace for computing power. It allows resource providers (sellers) to share CPU, GPU, and storage with buyers who need scalable and affordable computing — similar to AWS EC2, but in a peer-to-peer model.\n\n---\n\n## 📦 Repository Breakdown\n\n### [`lumaris_agent`](https://github.com/BDR-Pro/lumaris_agent)\n\n\u003e **Role**: The lightweight node agent installed on seller machines.\n\n**Key Responsibilities:**\n\n- Registers and authenticates the seller node with the Lumaris backend.\n- Exposes resource availability (CPU, RAM, GPU, etc.) to the central system.\n- Receives and executes buyer workloads in isolated environments (e.g., VMs or containers).\n- Maintains secure communication with the backend (TLS/mTLS).\n- Provides health monitoring and uptime metrics for reward calculations.\n\n**Technology Stack**:\n- Python-based\n- Uses system-level resource reporting and sandboxing tools\n\n---\n\n### [`lumaris_api`](https://github.com/BDR-Pro/lumaris_api)\n\n\u003e **Role**: The centralized API and matchmaking engine (control plane).\n\n**Key Responsibilities:**\n\n- Handles user registration, authentication, and API key management.\n- Matches buyers to available sellers based on resource requirements and region.\n- Manages job submission, pricing, and escrow/payment flows.\n- Stores metadata about nodes, workloads, and transactions.\n- Exposes both REST and WebSocket APIs for integration with the frontend or CLI.\n\n**Technology Stack**:\n- Python (FastAPI)\n- PostgreSQL for persistent data\n- Redis or similar for in-memory queues or real-time tasks\n\n---\n\n## 🔗 How They Work Together\n\n1. **Startup**: A seller installs and runs `lumaris_agent`, which connects to `lumaris_api` to authenticate and report availability.\n2. **Job Submission**: A buyer uses the API to request resources.\n3. **Matchmaking**: `lumaris_api` selects a suitable seller node and dispatches the workload to the corresponding agent.\n4. **Execution**: `lumaris_agent` runs the job, monitors its state, and reports progress/results back to the API.\n5. **Payment and Logs**: On successful job completion, `lumaris_api` triggers payment flows and retains logs or artifacts if required.\n\n---\n\n## 🚧 Future Plans\n\n- Token-based rewards for high-uptime agents\n- Web-based dashboard for both buyers and sellers\n- Enhanced security via encrypted disk I/O and ZK-proofs\n\n---\n\n## 🧠 Why Separate Repos?\n\nKeeping `agent` and `api` in separate repositories allows for:\n\n- Independent versioning and deployment\n- Clear separation of responsibilities\n- Easier contribution and testing for specific subsystems\n\n---\n\n## 📁 This Repo\n\nThis documentation repo serves as the architectural overview and index for the Lumaris project. It may also contain:\n\n- Diagrams\n- Developer onboarding notes\n- Contribution guides\n- CI/CD pipeline descriptions\n\n---\n\n## 📬 Contact\n\nFor business inquiries, integration discussions, or bug reports, please open an issue\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fpetabyte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdr-pro%2Fpetabyte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fpetabyte/lists"}