{"id":51095938,"url":"https://github.com/drmikecrypto/pc-lab-kit","last_synced_at":"2026-06-24T06:35:18.112Z","repository":{"id":364894167,"uuid":"1269614224","full_name":"drmikecrypto/pc-lab-kit","owner":"drmikecrypto","description":"PCVerse — local PC diagnostic lab: HWiNFO-style health scan, live sensors, RGB, benchmarks, optional AI advisor. Windows \u0026 Linux installers.","archived":false,"fork":false,"pushed_at":"2026-06-15T02:09:53.000Z","size":30919,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-15T02:23:25.940Z","etag":null,"topics":["cpu-benchmark","elastic-license","gpu-diagnostics","gpu-z","hardware-monitoring","health-check","hwinfo","linux","local-first","open-source-alternative","pc-building","pc-diagnostics","php","privacy","rgb-control","system-diagnostics","telemetry","windows"],"latest_commit_sha":null,"homepage":"https://github.com/drmikecrypto/pc-lab-kit#readme","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/drmikecrypto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-14T23:39:04.000Z","updated_at":"2026-06-15T00:38:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/drmikecrypto/pc-lab-kit","commit_stats":null,"previous_names":["drmikecrypto/pc-lab-kit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/drmikecrypto/pc-lab-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fpc-lab-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fpc-lab-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fpc-lab-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fpc-lab-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/drmikecrypto","download_url":"https://codeload.github.com/drmikecrypto/pc-lab-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/drmikecrypto%2Fpc-lab-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34720921,"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":"online","status_checked_at":"2026-06-24T02:00:07.484Z","response_time":106,"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":["cpu-benchmark","elastic-license","gpu-diagnostics","gpu-z","hardware-monitoring","health-check","hwinfo","linux","local-first","open-source-alternative","pc-building","pc-diagnostics","php","privacy","rgb-control","system-diagnostics","telemetry","windows"],"created_at":"2026-06-24T06:35:17.257Z","updated_at":"2026-06-24T06:35:18.102Z","avatar_url":"https://github.com/drmikecrypto.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PCVerse — local PC laboratory\n\n**PCVerse** is a local-first PC test lab: hardware probe, health scoring, live telemetry, RGB control, and an optional AI advisor (your API key). Everything runs on your machine — no cloud account required.\n\n## Download (one click per platform)\n\n| Platform | What you get |\n|----------|--------------|\n| **Windows 64-bit** | `PCVerse-Setup-Windows-x64.exe` — full lab, bundled PHP 8.3, Probe, desktop shortcut — **no PHP/Composer/.NET install** |\n| **Linux 64-bit** | `PCVerse-Setup-Linux-x64.run` — guided install, bundled PHP, folder picker, desktop shortcut — **no apt/brew PHP step** |\n\nOpen **http://127.0.0.1:8080/download** in the running lab, or build installers locally:\n\n```powershell\n.\\scripts\\build-release.ps1\n```\n\n### Windows — user flow\n\n1. Download **PCVerse-Setup-Windows-x64.exe**\n2. Run it → choose install folder → tick **Create desktop shortcut**\n3. Double-click **PCVerse** on the desktop (or `PCVerse.bat` in the install folder)\n\n### Linux — user flow\n\n1. Download **PCVerse-Setup-Linux-x64.run**\n2. `chmod +x PCVerse-Setup-Linux-x64.run \u0026\u0026 ./PCVerse-Setup-Linux-x64.run`\n3. Pick folder, optional desktop shortcut, launch from **PCVerse** shortcut\n\nRequires nothing else — PHP is bundled inside the `.run` installer.\n\n## Developers (Git clone)\n\n**Requirements:** Git only for a normal setup. **`.\\scripts\\install.ps1`** (Windows) or **`./scripts/install.sh`** (Linux) auto-download **PHP 8.3**, **Composer**, and (for building the Windows `.exe`) **.NET 8 SDK** into `build-cache/` on first run.\n\n```powershell\ngit clone https://github.com/drmikecrypto/pc-lab-kit.git\ncd pc-lab-kit\n.\\scripts\\install.ps1\n.\\scripts\\start.ps1\n```\n\n```bash\ngit clone https://github.com/drmikecrypto/pc-lab-kit.git\ncd pc-lab-kit\nchmod +x scripts/install.sh scripts/start.sh\n./scripts/install.sh\n./scripts/start.sh\n```\n\nOpen **http://127.0.0.1:8080/diagnostic**\n\n## Optional AI advisor (BYOK)\n\nPCVerse can turn each scan into **expert hardware analysis** — bottleneck diagnosis, upgrade plan, thermal risks, and comparison vs your last test. This is **optional**; the lab works fully without it.\n\n### How to enable\n\n1. Open the lab → click **Settings** in the top nav (or **AI advisor** under the page title).\n2. Paste an **OpenAI-compatible API key** (`sk-…`).\n3. Set **API base URL** (default `https://api.openai.com/v1`) and **model**.\n   - Recommended for best analysis: `gpt-4o` or `gpt-4.1`\n   - Default / budget: `gpt-4o-mini`\n4. Click **Save**. The key is stored locally in `storage/settings/local.json` — not sent to PCVerse servers.\n\nWorks with any OpenAI-compatible provider (OpenAI, Azure OpenAI, local Ollama with `/v1`, etc.).\n\n### When analysis runs\n\nAfter you finish a **Quick scan** or **Full scan**, PCVerse sends your diagnostic results (scores, temps, bottleneck, history comparison, benchmark context) to **your** LLM and shows:\n\n- **Headline** — the main finding  \n- **Summary** — what it means and what to do  \n- **Do this first** — priority actions  \n- **Upgrade plan** — ranked component recommendations  \n- **Thermal \u0026 stability** — burn-in / PSU / throttle risks  \n- **Changes since last test** — if you have saved history  \n\n### Alternative: `.env`\n\n```env\nLLM_API_KEY=sk-your-key-here\nLLM_BASE_URL=https://api.openai.com/v1\nLLM_MODEL=gpt-4o\n```\n\nWhen `LLM_API_KEY` is set in `.env`, it overrides the UI-saved key.\n\n## Tests\n\n```powershell\ncomposer test\n```\n\n## License\n\nPCVerse is **source available** under the [Elastic License 2.0](LICENSE) — not OSI “open source.”\n\n| Allowed | Not allowed |\n|---------|-------------|\n| Download, install, and run locally | Offer PCVerse (or a substantial fork) as a **hosted/managed service** to third parties |\n| Study, modify, and contribute back | Remove copyright or license notices |\n| Use for personal, team, or internal lab work | Use the **PCVerse** name for a competing cloud product (see [TRADEMARK.md](TRADEMARK.md)) |\n\nThe official hosted PCVerse SaaS will come from the licensor only: [github.com/drmikecrypto](https://github.com/drmikecrypto).\n\n**Commercial licensing** (OEM, white-label, managed service, trademark): contact via GitHub before launch.\n\nThird-party dependencies in `vendor/` remain under their respective licenses (mostly MIT).\n\n## Docs\n\nAll documentation is under **[docs/](docs/README.md)**.\n\n| Doc | Purpose |\n|-----|---------|\n| [FAQ](docs/FAQ.md) | Common questions (search + AI friendly) |\n| [Integration guide](docs/INTEGRATION.md) | Kit layout, routes, Flutter contract |\n| [Mobile API routes](docs/API_MOBILE_ROUTES.md) | Flutter ↔ PHP endpoint map |\n| [Contributing](CONTRIBUTING.md) | PR guidelines |\n| [Changelog](CHANGELOG.md) | Version history |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrmikecrypto%2Fpc-lab-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdrmikecrypto%2Fpc-lab-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdrmikecrypto%2Fpc-lab-kit/lists"}