{"id":51429529,"url":"https://github.com/caiovaz567/hyperion-mod-manager","last_synced_at":"2026-07-05T03:02:18.502Z","repository":{"id":352557591,"uuid":"1213215742","full_name":"caiovaz567/Hyperion-Mod-Manager","owner":"caiovaz567","description":"Desktop mod manager for Cyberpunk 2077 - install/reinstall mods, detect file and archive conflicts, manage load order, and launch the game.","archived":false,"fork":false,"pushed_at":"2026-06-28T21:43:20.000Z","size":30016,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-28T22:13:26.444Z","etag":null,"topics":["claude-code","cyberpunk-2077","desktop-app","electron","mod-manager","modding","typescript","vibe-coding","windows"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caiovaz567.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T06:44:52.000Z","updated_at":"2026-06-28T21:43:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/caiovaz567/Hyperion-Mod-Manager","commit_stats":null,"previous_names":["caiomarcelo567/hyperion-mod-manager","caiovaz567/hyperion-mod-manager"],"tags_count":55,"template":false,"template_full_name":null,"purl":"pkg:github/caiovaz567/Hyperion-Mod-Manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiovaz567%2FHyperion-Mod-Manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiovaz567%2FHyperion-Mod-Manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiovaz567%2FHyperion-Mod-Manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiovaz567%2FHyperion-Mod-Manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caiovaz567","download_url":"https://codeload.github.com/caiovaz567/Hyperion-Mod-Manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caiovaz567%2FHyperion-Mod-Manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35141966,"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-07-05T02:00:06.290Z","response_time":100,"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":["claude-code","cyberpunk-2077","desktop-app","electron","mod-manager","modding","typescript","vibe-coding","windows"],"created_at":"2026-07-05T03:02:17.863Z","updated_at":"2026-07-05T03:02:18.475Z","avatar_url":"https://github.com/caiovaz567.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/main/resources/hyperion-logo.png\" alt=\"Hyperion\" width=\"520\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  A mod manager for Cyberpunk 2077.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/caiovaz567/Hyperion-Mod-Manager?color=006FEE\u0026label=release\u0026cacheSeconds=300\" alt=\"Latest release\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/game-Cyberpunk%202077-fcee09\" alt=\"Game: Cyberpunk 2077\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Windows-ff3b30\" alt=\"Platform: Windows\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/caiovaz567/Hyperion-Mod-Manager?color=34d399\" alt=\"License: GPL-3.0\" /\u003e\n\u003c/p\u003e\n\n---\n\nHyperion is a desktop application for managing Cyberpunk 2077 mods. It keeps your mod library organized, installs mods without touching the game folder, detects conflicts, and launches the game - all from one place.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/ec164022-4c90-4e4f-8838-36a3aefb043c\" alt=\"Hyperion\" width=\"900\" /\u003e\n\u003c/p\u003e\n\n## Why Hyperion Exists\n\nHyperion started as a small personal experiment: I wanted to try Claude Code, had just started modding Cyberpunk 2077, and thought building a mod manager for my own setup would be a fun test project. Then the fun part got a little out of hand.\n\nSince then, Hyperion has become the manager I use for my own Cyberpunk 2077 mod list. It grew around the things I wanted day to day: a clean library, clear conflicts, predictable load order, and a launch flow that keeps the game folder under control. After using it privately for a while, I decided to make it public in case it is useful to someone else too.\n\n## Features\n\n### Library\n- **Full mod library management** - enable/disable per mod or in bulk, group mods with collapsible separators, and reorder load priority by drag-and-drop (higher order wins on shared paths)\n- **Conflict detection** - flags both file-path overwrites and archive-resource conflicts (internal RED4 hash collisions across `.archive` files), with a per-mod win/loss breakdown and one-click jump to the winning/losing mod\n- **FOMOD installer** - full wizard support for conditional installs (body type, textures, options) with image previews\n- **Archive support** - install from `.zip`, `.rar`, and `.7z`, with live extraction progress and reinstall from the original source at any time\n- **Built to scale** - stays fast and light on memory with thousands of mods and downloads\n\n### Game folder stays clean\n- **Virtual deployment (usvfs)** - mods are mapped over the game tree at launch using usvfs, the same User-Space VFS behind Mod Organizer 2. Nothing is copied or linked into the game folder; the library stays the source of truth, and only tiny runtime bootstrap files are staged when needed. Game, library, and downloads can each live on different drives\n- **REDmod support** - REDmods are compiled and loaded entirely inside the virtual file system: Hyperion runs `redMod deploy` against the virtual `mods/` tree, captures the compiled output outside the game folder, respects your library load order, and launches the game with `-modded`\n- **Runtime captures** - files written by mod tools during gameplay (CET keybindings, generated configs, logs) are captured in a managed Overwrite folder and replayed on future launches, so settings persist while the game folder stays untouched\n\n### Nexus Mods\n- **One-click installs** via `nxm://` links, with automatic install after download\n- **Update detection** scoped to each installed file's own lineage - an optional file is never flagged against an unrelated main release\n- **Premium/Free aware** download handling, plus MD5 identity recovery for manually downloaded archives\n\n### Interface\n- **Modern UI** built with HeroUI - dark and light modes (or follow the system), with eight accent colors that re-skin the entire app live\n- **Multilingual** - English and Brazilian Portuguese, switchable live; the architecture is ready for community translations\n- **Live launch feedback** - a progress card narrates the whole launch pipeline (mod scan, VFS mount, REDmod compilation, game start) with real tool output\n- **App logs** - built-in inspector for runtime events and Nexus API traffic, with masked credentials\n- **Automatic updates** - delivered through GitHub Releases with one-click install\n\n## Requirements\n\n- Windows 10 / 11 (64-bit)\n- A copy of Cyberpunk 2077\n\n## Getting started\n\nDownload the latest Windows installer from the [Releases](https://github.com/caiovaz567/Hyperion-Mod-Manager/releases/latest) page.\n\nOn first launch, a one-time setup wizard walks you through everything Hyperion needs:\n\n1. **Game** - where Cyberpunk 2077 is installed (auto-detected in the background)\n2. **Mod library** - the folder that holds your installed mods\n3. **Downloads** - the folder Hyperion watches for archives (optional)\n4. **Nexus** - your personal [Nexus Mods API key](https://www.nexusmods.com/settings/api-keys) for downloads and update checks (optional)\n\nEvery path is validated inline, and anything you skip can be set later in **Settings**.\n\n## Tech stack\n\n| Layer | Technology |\n|---|---|\n| Shell | [Electron](https://www.electronjs.org/) (main process in TypeScript) |\n| UI | [React 19](https://react.dev/) + [HeroUI v3](https://heroui.com/) + [Tailwind CSS v4](https://tailwindcss.com/) |\n| State | [Zustand](https://zustand-demo.pmnd.rs/) |\n| Virtual file system | [usvfs](https://github.com/ModOrganizer2/usvfs) via a native Node.js bridge |\n| Packaging \u0026 updates | electron-builder + GitHub Releases |\n\n## Building from source\n\n```bash\nnpm install\nnpm run fetch:usvfs   # fetch the pinned usvfs binaries\nnpm run build:native  # build the usvfs native bridge\nnpm run dev           # run in development\nnpm run build         # build a local installer\n```\n\n## License\n\nHyperion is free software licensed under the [GNU General Public License v3.0](LICENSE).\n\nVirtual deployment is powered by [usvfs](https://github.com/ModOrganizer2/usvfs) (GPL-3.0, © Sebastian Herbord / Mod Organizer 2 contributors). See [`native/usvfs-bridge/THIRD_PARTY_LICENSES.md`](native/usvfs-bridge/THIRD_PARTY_LICENSES.md) for the full notice.\n\n---\n\n\u003csub\u003eHyperion is an unofficial, fan-made tool and is not affiliated with or endorsed by CD PROJEKT RED.\u003c/sub\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaiovaz567%2Fhyperion-mod-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaiovaz567%2Fhyperion-mod-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaiovaz567%2Fhyperion-mod-manager/lists"}