repowiserepowise

itsnotrexed / leonida Architecture and code health

Leonida Is A Native PC Recompilation Of The Xbox Version Of Grand Theft Auto 6

★ 9,792stars on GitHubPythonGPL-3.0

This connects Repowise to itsnotrexed/leonida's code. It does not install leonida.

Repowise maps public repos from their source. Not affiliated with itsnotrexed. What is Repowise?

github.com/itsnotrexed/leonidaIndexed at 91b36cf

What is leonida?

leonida is a static recompilation project for running the Xbox Series version of Grand Theft Auto VI natively on Windows. It loads the game's x86-64 code directly on the PC, reimplements the console's system software, and translates the RDNA2 GPU programs to SPIR-V for Vulkan. The repository does not contain the game, so the build uses the user's own copy. Python is the main language, with C++ and C# files as well. To install it, run git clone https://github.com/itsnotrexed/leonida.git and follow the steps below. Its code health is 6.4 out of 10 (Fair), ranked #192 of 4,000+ indexed repos. The last commit to leonida was on Nov 22, 2026, and 77 people have contributed.

As of commit 91b36cf, indexed Nov 22, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentsleonida.md

Repo facts: type, license, health, rank, contributors
leonida facts
LicenseGPL-3.0
Code health6.4 / 10 (Fair)
Health rank#192 of 4,000+ indexed repos
Last commitNov 22, 2026
Contributors77
Bus factor5
Size389 files, 94,913 lines

Install leonida

Commands copied from the README

  1. 1Clone the leonida repository.
    git clone https://github.com/itsnotrexed/leonida.git
  2. 2Move into the leonida folder.
    cd leonida
  3. 3From a terminal, build against your copy of the game, with the output in a chosen folder and the work files on another drive.
    python -I make_game.py --game "D:\path\to\your\package" --out "D:\Games\Leonida" --work "E:\leonida-work"

Full install notes on GitHub

Explore leonida

Ask about this code in your agent

This connects Repowise to leonida's code. It does not install leonida. To install leonida, use the install steps.

Useful if you want to change or fork leonida: your agent can ask how it is put together and get answers that cite its files.

Ask about leonida

Answers come from leonida's README and source, with the files they cite. Two free answers a day without an account.

Featured answer

leonida is a static recompilation project that runs the Xbox Series version of Grand Theft Auto VI natively on Windows, loading the game's x86-64 code directly on the PC and translating its RDNA2 GPU programs to SPIR-V for Vulkan. The repository does not include the game, so the build uses the user's own copy, and the project is written mainly in Python with some C++ and C# files. make_game.py is the build driver, running the check, shaders, assets, runtime and pipelines stages in order, and its version check compares each package file's name, size and SHA-256 with the supported versions. The shader path runs from tools/shader_carve.py through fssm_unpack.py, shader_disasm.py (LLVM for gfx1013) and rdna2spirv.py, while asset export uses tools/rpf9dump on RPF9 archives and loose .ttpf texture pools. The runtime in runtime/ maps the PE image and redirects its imports to GDK, XMem and d3d12_xs shims, starting at runtime/src/main.cpp, and the finished build is written to Documents\Leonida by default. The architecture chart shows four layers across 389 files: Application with 59, Config with 8, Utility with 78, and Docs & Tooling with 38, so a good place to start is make_game.py and runtime/src/main.cpp.

Files per layer in leonida4 layers.

Basis: Inferred · knowledge graph· as of 91b36cf

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of itsnotrexed/leonida from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

itsnotrexed/leonida FAQ

What is leonida?

leonida is a static recompilation project that runs the Xbox Series version of Grand Theft Auto VI natively on Windows. It is built on your PC from your own copy of the game, which the repository does not include.

How does leonida work?

leonida loads the game's x86-64 code on the PC and reimplements the console's system software. Its build translates the RDNA2 GPU programs to SPIR-V for Vulkan and reads models, textures and audio from your package.

How do I install leonida?

leonida is not downloaded ready-made; it is built on your PC. Install the listed prerequisites, download the project with its submodule, and run Build.bat, or run make_game.py from a terminal with the --game option. See the install steps

What language is leonida written in?

leonida is written mainly in Python, with C++ files for the runtime and C# files for a tool. Its code also includes one JavaScript file.

How is the leonida code organized?

make_game.py at the top level drives the build. The tools directory holds the shader and asset pipeline and the research tools, and the runtime directory holds the code that maps the game image and provides the shims.

Who is leonida for?

leonida is aimed at people who have their own copy of the Xbox Series package of Grand Theft Auto VI, version 1.0.2.1, and want to build a native Windows version from it. It is also aimed at developers who can work on booting the game.

What license does leonida use?

leonida is licensed under GPL-3.0. The license applies to the code in the repository, which does not include the game itself.

Code health

6.4out of 10Fair

Hotspots average 4.4, the place fixes pay off most.

On the leaderboards:#54 of 71 Python repos

Key features of leonida

  • Runs the Xbox Series version of Grand Theft Auto VI natively on Windows, built on the user's own PC from the user's own copy of the game.
  • Translates the precompiled RDNA2 GPU programs of the game to SPIR-V for Vulkan.
  • Reads the game's models, textures and audio from the user's package on disk.
  • Finds the game copy on the PC, checks the prerequisites and lists anything missing before the build starts.
  • Early in development: the game does not boot yet.

How itsnotrexed/leonida works

make_game.py is the build driver. It runs the stages check, shaders, assets, runtime and pipelines in order, and its version check compares each package file's name, size and SHA-256 with the supported versions. The shader pipeline starts in tools/shader_carve.py, which carves DXBC containers out of shaders.rpf, and fssm_unpack.py then unpacks the native RDNA2 program. shader_disasm.py disassembles that program with LLVM for gfx1013, and rdna2spirv.py translates it to SPIR-V. Asset export runs through tools/rpf9dump, which finds resources inside RPF9 archives and the loose .ttpf texture pools. The runtime in runtime/ maps the PE image and resolves its imports to shims for GDK, XMem and d3d12_xs, with runtime/src/main.cpp as its entry point. The finished build is written to Documents\Leonida by default.

The codebase has 389 files and 7,772 symbols in 7 modules, led by Python, C++ and C#. Code health is 6.4 out of 10, rated fair.