firaslatrech/codecity

CodeCity takes any public GitHub repository and turns it into a small 3D city you can actually drive around in your browser. Each file in the repo becomes a building, with its height based on how many lines of code it has and its footprint based on its size, and each folder becomes a district, so the overall shape of the repository turns into a street layout you can navigate like a town. Files that get changed the most often show up as buildings with glowing windows, and the repository's top contributors appear as faces near the entrance, using their real GitHub avatars. You get to pick from three drivable cars, each with its own handling and an engine sound built entirely from synthesized audio rather than sound files. Pressing different keys unlocks extra modes: watching the city rebuild itself commit by commit over time, racing through a set of checkpoint gates, collecting coins scattered through the streets, or saving a short video clip and image of your city to share. You can also drive up to any building and press a key to open and read that actual file from the repository. If you provide a free Groq API key, an AI model will look at the repository's statistics and pick a handful of landmark buildings to highlight along with a short city motto, though this step is entirely optional and the city works fine without it. Running it yourself only requires cloning the project, installing dependencies with npm, and starting the development server, after which you paste in any public GitHub repository URL and the tool fetches just enough of the repository, not a full copy, to build the city. The whole renderer depends on only two external libraries, three.js for the 3D graphics and Vite for running the development server, while a separate small script does all the analysis of the repository itself using only Node's built in tools. Very large repositories are handled by capping how many files and how much commit history get processed, so things stay fast even on big codebases. It is released under the MIT license.