rendergit  by karpathy

Flatten GitHub repos into a single HTML page

Created 1 week ago

New!

1,442 stars

Top 28.3% on SourcePulse

GitHubView on GitHub
Project Summary

This tool addresses the need to quickly access and review code within any Git repository by rendering it into a single, static HTML page. It is designed for developers, code reviewers, and users interacting with Large Language Models (LLMs) who want a streamlined, searchable interface for exploring codebases without navigating complex file structures. The primary benefit is an instant, unified view of all repository code, enhancing efficiency for code review and LLM-based analysis.

How It Works

The tool clones a specified GitHub repository to a temporary directory and then processes its source code. It renders the code into a single static HTML file, incorporating syntax highlighting for code files (via Pygments) and markdown rendering for documentation files like READMEs. The process includes smart filtering to exclude binary or excessively large files, and generates a sidebar for navigation. A key feature is the dual-view mode, allowing users to switch between a human-readable, prettified interface and a CXML text format optimized for copy-pasting into LLMs.

Quick Start & Requirements

  • Install via pip: pip install -e . after cloning the repository.
  • Usage: rendergit <github_url> (e.g., rendergit https://github.com/karpathy/nanoGPT).
  • Prerequisites: Python environment. No specific hardware or external API keys are mentioned.

Highlighted Details

  • Dual view modes: Human View (syntax highlighting, navigation) and LLM View (CXML text for LLMs).
  • Syntax highlighting via Pygments.
  • Markdown rendering for READMEs.
  • Smart filtering of binaries and large files.
  • Responsive design with sidebar navigation.

Maintenance & Community

The project is shared by the author (karpathy) who uses it frequently but does not intend to actively maintain or support it. No specific community channels or contribution guidelines beyond the general sharing of the utility are mentioned.

Licensing & Compatibility

  • License: BSD-0. This is a very permissive license, allowing for unrestricted use, modification, and distribution, including for commercial purposes.
  • Compatibility: Compatible with any Git repository accessible via a GitHub URL.

Limitations & Caveats

The project is explicitly stated as not intended for active maintenance or support by the author, suggesting potential limitations in future updates or bug fixes. While it handles large codebases, performance with extremely large repositories or a very high number of files might be a consideration, though not explicitly detailed.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
11
Issues (30d)
9
Star History
1,455 stars in the last 9 days

Explore Similar Projects

Starred by David Cournapeau David Cournapeau(Author of scikit-learn), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
7 more.

repomix by yamadashy

0.7%
19k
CLI tool to pack codebases into AI-friendly formats for LLMs
Created 1 year ago
Updated 1 day ago
Feedback? Help us improve.