/`
AI README generator — free, no signup

Generate a README from any GitHub repository

Paste your repo URL. The AI reads your actual code — files, dependencies, folder structure — and writes a complete README.md. Works on public repos without login and private repos with GitHub OAuth.

Public repos — no loginPrivate repos — GitHub OAuthCommit directly to GitHubFree, no signup

GitHub repository URL

paste your repo URL…Generate
Public — no login Private — GitHub OAuth

Repo URL → AI scans files → generates README → edit → commit to GitHub

What is an AI GitHub README generator?

An AI GitHub README generator automatically creates README.md files directly from a repository. It analyzes your codebase, dependencies, and project structure to write installation instructions, usage examples, feature lists, and other documentation sections — without you having to write them manually.

Unlike template-based tools that give you blank sections to fill in, this tool reads what's actually in your repo. It finds your package manager, detects your framework, reads your config files, and writes content that's accurate to your specific project.

Template generators

Give you blank sections to fill in
Generic placeholder text
Same output for every project

This tool

Reads your actual files and dependencies
Writes content specific to your project
Works on public and private GitHub repos
How it works

From repository URL to README.md in four steps

The automatic README generator handles the research. You handle the final review. Paste a URL, the AI reads your codebase, you get a draft — edit what you want, commit when ready.

01

Connect your repository

Public & private repos

Paste any public GitHub repo URL directly. For private repositories, connect your GitHub account via OAuth — the tool reads with your permission, never stores your code.

02

AI reads your actual code

Real code analysis

The AI scans your files, package dependencies, folder structure, and configuration. It identifies your tech stack — React, Node, Python, Go — and writes from what it finds, not from generic templates.

03

Get a complete README.md

GitHub-ready output

You receive a full README with Project Overview, Installation, Usage, Features, Tech Stack, Contributing, and License — structured correctly for GitHub, ready to ship or edit further.

04

Edit, save, and commit

Direct GitHub commit

Review and edit the output inside the built-in editor. Save it to your project list, or commit directly to your GitHub repository without leaving the tool.

Private repositories

Generate README files from private GitHub repos

Connect your GitHub account with OAuth. The tool lists your private repositories alongside public ones. Pick any repo — the AI generates the README the same way, no manual input needed. Your code is read to generate the content and nothing else.

GitHub OAuth — read-only, scoped access
Private repositories listed in your dashboard
Code is read to generate the README, never stored
Revoke access from GitHub settings at any time

Your repositories

my-saas-app
private
internal-api
private
portfolio-site
public
Bring your own API key

No generation limits with your own key

The tool works on a shared Gemini quota by default. Add your own free Gemini API key from Google AI Studio to remove throttling and generate as many READMEs as you need. The key is stored in your browser only — sent to the server only during generation.

Gemini API Key

●●●●●●●●●●●●●●●●●●Gemini 2.5 Flash Lite
Custom key active in this browser

Stored locally. Sent to server only when generating.

Direct GitHub commit

Commit the README without leaving the tool

After reviewing and editing the generated README, commit it directly to your repository with one click. No copy-pasting into another editor.

Review and edit before committing
Commit message auto-filled
Pushes to the correct branch
Saved to your project list for future edits
What gets generated

Every section a good README needs

The AI writes all standard sections based on what it finds in your repo. Every section is editable before you save or commit.

Project overview
Installation steps
Usage guide
Features list
Tech stack
API documentation
Configuration
Contributing guide
License
Screenshots
Supported tech stacks

Works with most GitHub projects

The AI detects your stack from actual files — package.json, requirements.txt, go.mod, Cargo.toml, pom.xml. No manual selection needed.

Next.jsReactNode.jsPythonJavaGoRustC++TypeScriptVueFastAPIDjango

Best results and known limitations

This tool works best on small to medium-sized repositories. AI models have context window limits — very large codebases, enterprise monorepos, or repositories with hundreds of files may not be fully analyzed in one pass.

For large projects, generate documentation per module or per sub-repository for the most accurate output.

Ready to generate a README from your GitHub repository?

Paste a public repo URL and get a complete README.md in seconds — no signup, no credit card. For private repositories and unlimited generation, connect GitHub and add your own API key.

Free · Public repos need no login · Private repos via GitHub OAuth