Readme AI AI Agent

by eli64s• 3k•• Scanned•Claim this listing•Request removal

Content & Writingagentsaiai agentsai documentationanthropic

README file generator, powered by AI.

Readme AI is an open-source ai agent by eli64s, written mainly in Python, with 3,006 GitHub stars and the MIT license. Its code was last updated Oct 28, 2026.

about README security reviews

<div id="top"> <p align="center"> <div align="center"> <a href="https://github.com/eli64s/readme-ai"> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/e2a5f0ab93b923a78935178dd165d5019b4a1fbc/docs/docs/assets/svg/logo.svg" alt="ReadmeAI Logo" width="60%"> </a> </div>  </p> <p align="center"> <em>Designed for simplicity, customization, and developer productivity.</em> </p>   <p align="center"> <a href="https://github.com/InnerAura/hyperweave" title="Rendered with HyperWeave"> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/main/assets/readmeai-strip.svg" alt="readme-ai · stars · forks · version"> </a> </p> <p align="center"> <a href="https://github.com/InnerAura/hyperweave" title="Star history rendered with HyperWeave"> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/main/assets/readmeai-star-chart.svg" alt="readme-ai star history rendered by HyperWeave" width="100%"> </a> </p> <p align="center"> <sub>The metrics above are rendered with <a href="https://github.com/InnerAura/hyperweave"><b>HyperWeave</b></a> — an experimental SVG artifact layer for agents.  <a href="https://github.com/InnerAura/hyperweave"><b>Explore →</b></a></sub> </p> </div> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

[!IMPORTANT] Explore the Official Documentation for a complete list of features, customization options, and examples.

Introduction

ReadmeAI is a developer tool that automatically generates README files using a robust repository processing engine and advanced language models. Simply provide a URL or path to your codebase, and a well-structured and detailed README will be generated.

Why Use ReadmeAI?

This project aims to streamline the process of creating and maintaining documentation across all technical disciplines and experience levels. The core principles include:

🔵 Automate: Generate detailed and structured README files with a single command.
⚫️ Customize: Select from a variety of templates, styles, badges, and much more.
🟣 Flexible: Switch between OpenAI, Ollama, Anthropic, and Gemini anytime.
🟠 Language Agnostic: Compatible with a wide range of languages and frameworks.
🟡 Best Practices: Ensure clean and consistent documentation across all projects.
🟢 Smart Filtering: Intelligent file analysis with customizable .readmeaiignore patterns.
⛔️ Offline Mode: Create README files offline, without using a LLM API service.

Demo

Run from your terminal:

readmeai-cli-demo

<img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

Features

Customize Your README

Let's begin by exploring various customization options and styles supported by ReadmeAI:

<div align="left"> <h6>Header Styles</h6> <table>  <tr> <td align="left"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/assets/img/documentation/headers/variations/custom-dragon.png?raw=true" alt="Classic Header" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px;"> <p align="left"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/eli64s/readme-ai-streamlit \ &emsp13;--logo custom \ &emsp13;--badge-color FF4B4B \ &emsp13;--badge-style flat-square \ &emsp13;--header-style classic </code> </pre> </td> </tr>  <tr> <td align="left"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/assets/img/documentation/headers/variations/modern-for-the-badge.png?raw=true" alt="Modern Header" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px;"> <p align="left"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/olliefr/docker-gs-ping \ &emsp13;--badge-color 00ADD8 \ &emsp13;--badge-style for-the-badge \ &emsp13;--header-style modern \ &emsp13;--navigation-style roman </code> </pre> </td> </tr>  <tr> <td align="left"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/examples/styling/headers/compact.png?raw=true" alt="Compact Header" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px;"> <p align="left"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/rumaan/file.io-Android-Client \ &emsp13;--badge-style plastic \ &emsp13;--badge-color blueviolet \ &emsp13;--logo PURPLE \ &emsp13;--header-style COMPACT \ &emsp13;--navigation-style NUMBER \ &emsp13;--emojis solar </code> </pre> </td> </tr> </table>  <h3>Banner Styles</h3> <table> <tr> <td align="left"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/examples/styling/headers/console.png?raw=true" alt="Console Header" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px;"> <p align="left"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/emcf/thepipe \ &emsp13;--badge-style flat-square \ &emsp13;--badge-color 8a2be2 \ &emsp13;--header-style console \ &emsp13;--navigation-style accordion \ &emsp13;--emojis water </code> </pre> </td> </tr>  <tr> <td align="left"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/examples/styling/headers/svg-banner.png?raw=true" alt="SVG Banner" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px;"> <p align="left"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/FerrariDG/async-ml-inference \ &emsp13;--badge-style plastic \ &emsp13;--badge-color 43a047 \ &emsp13;--header-style BANNER </code> </pre> </td> </tr> </table>  <h3>And More!</h3> <table> <tr> <td align="left" style="padding: 20px;"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/assets/img/project-overview/introduction.png?raw=true" alt="Project Overview" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px; margin-bottom: 15px;"> <p align="left" style="margin: 10px 0;"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository 'https://github.com/eli64sreadme-ai-streamlit' \ &emsp13;--badge-style FLAT-SQUARE \ &emsp13;--badge-color E92063 \ &emsp13;--header-style COMPACT \ &emsp13;--navigation-style ACCORDION \ &emsp13;--emojis RAINBOW \ &emsp13;--logo ICE </code> </pre> </td> </tr>  <tr> <td align="left" style="padding: 20px;"> <img src="https://github.com/eli64s/readme-ai/blob/main/docs/docs/assets/img/documentation/headers/variations/cloud.png?raw=true" alt="Custom Logo" width="800" style="border: 1px solid #E7E9EB; border-radius: 5px; padding: 5px; margin-bottom: 15px;"> <p align="left" style="margin: 10px 0;"><b>CLI Command:</b></p> <pre align="left"> <code>$ readmeai --repository https://github.com/jwills/buenavista \ &emsp13;--align LEFT \ &emsp13;--badge-style FLAT-SQUARE \ &emsp13;--logo CUSTOM </code> </pre> </td> </tr> </table>   </div>

Generated Sections & Content

<details><summary><strong>꩜ Expand to view more!</strong></summary><br>

<h3>Project Introduction</h3> <ul><li>This section captures your project's essence and value proposition. </li><li>The prompt template used to generate this section can be viewed here. </li></ul>

<h3>Features Table</h3> <ul><li>Detailed feature breakdown and technical capabilities. </li><li> The prompt template used to generate this section can be viewed here. </li></ul>

<h3>Project Structure</h3> <ul><li>Visual representation of your project's directory structure. </li><li>The tree is generated using pure Python and embedded in a code block. </li></ul>

<h3>Project Index</h3> <ul><li>Summarizes key modules of the project, which are also used as context for downstream prompts.toml. </li></ul>

<h3>Getting Started Guides</h3> <ul><li>Dependencies and system requirements are extracted from the codebase during preprocessing. </li><li>The parsers handle most of the heavy lifting here. </li></ul>

<h3>Installation, Usage, & Testing</h3> <ul><li>Setup instructions and usage guides are automatically created based on data extracted from the codebase. </li></ul>

<h3>Community & Support</h3> <ul><li>Development roadmap, contribution guidelines, license information, and community resources. </li><li>A <em>return button</em> is also included for easy navigation. </li></ul>

<h3>Contribution Guides</h3> <ul><li>Instructions for contributing to the project, including resource links and a basic contribution guide. </li><li>Graph of contributors is also included for open-source projects. </li></ul>

</details> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

Getting Started

Prerequisites

ReadmeAI requires Python 3.10 or higher, and one of the following installation methods:

Requirement	Details
• Python ≥3.10	Core runtime
Installation Method (choose one)
• pip	Default Python package manager
• pipx	Isolated environment installer
• uv	High-performance package manager
• docker	Containerized environment

Supported Repository Platforms

To generate a README file, provide the source repository. ReadmeAI supports these platforms:

Platform	Details
File System	Local repository access
GitHub	Industry-standard hosting
GitLab	Full DevOps integration
Bitbucket	Atlassian ecosystem

Supported LLM API Services

ReadmeAI is model agnostic, with support for the following LLM API services:

Provider	Best For	Details
OpenAI	General use	Industry-leading models
Anthropic	Advanced tasks	Claude language models
Google Gemini	Multimodal AI	Latest Google technology
Ollama	Open source	No API key needed
Offline Mode	Local operation	No internet required

Installation

ReadmeAI is available on PyPI as readmeai and can be installed as follows:

<img width="2%" src="https://simpleicons.org/icons/python.svg"> Pip

Install with pip (recommended for most users):

❯ pip install -U readmeai

<img width="2%" src="https://simpleicons.org/icons/pipx.svg"> Pipx

With pipx, readmeai will be installed in an isolated environment:

❯ pipx install readmeai

<img width="2%" src="https://simpleicons.org/icons/uv.svg"> Uv

The fastest way to install readmeai is with uv:

❯ uv tool install readmeai

<img width="2%" src="https://simpleicons.org/icons/docker.svg"> Docker

To run readmeai in a containerized environment, pull the latest image from [Docker Hub][dockerhub-link]:

❯ docker pull zeroxeli/readme-ai:latest

<img width="2%" src="https://simpleicons.org/icons/git.svg"> From source

<details><summary><i>Click to build <code>readmeai</code> from source</i></summary>

Clone the repository:

❯ git clone https://github.com/eli64s/readme-ai

Navigate to the project directory:
```
❯ cd readme-ai
```

Install dependencies:

❯ pip install -r setup/requirements.txt

Alternatively, use the [setup script][setup-script] to install dependencies:

<img width="1.5%" src="https://simpleicons.org/icons/gnubash.svg"> Bash

Run the setup script:
```
❯ bash setup/setup.sh
```

Or, use poetry to build and install project dependencies:

<img width="1.5%" src="https://simpleicons.org/icons/poetry.svg"> Poetry

Install dependencies with poetry:
```
❯ poetry install
```

</details> <br>

Additional Optional Dependencies

[!IMPORTANT] To use the Anthropic and Google Gemini clients, extra dependencies are required. Install the package with the following extras:
Anthropic:
❯ pip install "readmeai[anthropic]"
Google Gemini:
❯ pip install "readmeai[google-generativeai]"
Install Multiple Clients:
❯ pip install "readmeai[anthropic,google-generativeai]"

Usage

Set your API key

When running readmeai with a third-party service, you must provide a valid API key. For example, the OpenAI client is set as follows:

❯ export OPENAI_API_KEY=<your_api_key>

# For Windows users:
❯ set OPENAI_API_KEY=<your_api_key>

<details closed><summary>Click to view environment variables for - <code>Ollama</code>, <code>Anthropic</code>, <code>Google Gemini</code></summary> <br> <details closed><summary>Ollama</summary> <br>

Refer to the Ollama documentation for more information on setting up the Ollama server.

To start, follow these steps:

Pull your model of choice from the Ollama repository:
```
❯ ollama pull llama3.2:latest
```
Start the Ollama server and set the OLLAMA_HOST environment variable:
```
❯ export OLLAMA_HOST=127.0.0.1 && ollama serve
```

</details> <details closed><summary>Anthropic</summary>

Export your Anthropic API key:

❯ export ANTHROPIC_API_KEY=<your_api_key>

</details> <details closed><summary>Google Gemini</summary>

Export your Google Gemini API key:

❯ export GOOGLE_API_KEY=<your_api_key

</details> </details>

Using the CLI

Running with a LLM API service

Below is the minimal command required to run readmeai using the OpenAI client:

❯ readmeai --api openai -o readmeai-openai.md -r https://github.com/eli64s/readme-ai

[!IMPORTANT] The default model set is gpt-3.5-turbo, offering the best balance between cost and performance.When using any model from the gpt-4 series and up, please monitor your costs and usage to avoid unexpected charges.

ReadmeAI can easily switch between API providers and models. We can run the same command as above with the Anthropic client:

❯ readmeai --api anthropic -m claude-3-5-sonnet-20240620 -o readmeai-anthropic.md -r https://github.com/eli64s/readme-ai

And finally, with the Google Gemini client:

❯ readmeai --api gemini -m gemini-1.5-flash -o readmeai-gemini.md -r https://github.com/eli64s/readme-ai

Running with local models

We can also run readmeai with free and open-source locally hosted models using the Ollama:

❯ readmeai --api ollama --model llama3.2 -r https://github.com/eli64s/readme-ai

Running on a local codebase

To generate a README file from a local codebase, simply provide the full path to the project:

❯ readmeai --repository /users/username/projects/myproject --api openai

Adding more customization options:

❯ readmeai --repository https://github.com/eli64s/readme-ai \
           --output readmeai.md \
           --api openai \
           --model gpt-4 \
           --badge-color A931EC \
           --badge-style flat-square \
           --header-style compact \
           --navigation-style fold \
           --temperature 0.9 \
           --tree-depth 2
           --logo LLM \
           --emojis solar

Running in offline mode

ReadmeAI supports offline mode, allowing you to generate README files without using a LLM API service.

❯ readmeai --api offline -o readmeai-offline.md -r https://github.com/eli64s/readme-ai

<img width="2%" src="https://simpleicons.org/icons/docker.svg"> Docker

Run the readmeai CLI in a Docker container:

❯ docker run -it --rm \
    -e OPENAI_API_KEY=$OPENAI_API_KEY \
    -v "$(pwd)":/app zeroxeli/readme-ai:latest \
    --repository https://github.com/eli64s/readme-ai \
    --api openai

<img width="2%" src="https://simpleicons.org/icons/streamlit.svg"> Streamlit

Try readme-ai directly in your browser on Streamlit Cloud, no installation required.

See the readme-ai-streamlit repository on GitHub for more details about the application.

[!WARNING] The readme-ai Streamlit web app may not always be up-to-date with the latest features. Please use the command-line interface (CLI) for the most recent functionality.

<img width="2%" src="https://simpleicons.org/icons/git.svg"> From source

<details><summary><i>Click to run <code>readmeai</code> from source</i></summary>

<img width="1.5%" src="https://simpleicons.org/icons/gnubash.svg"> Bash

If you installed the project from source with the bash script, run the following command:

Activate the virtual environment:
```
❯ conda activate readmeai
```

Run the CLI:

❯ python3 -m readmeai.cli.main -r https://github.com/eli64s/readme-ai

<img width="1.5%" src="https://simpleicons.org/icons/poetry.svg"> Poetry

Activate the virtual environment:
```
❯ poetry shell
```

Run the CLI:

❯ poetry run python3 -m readmeai.cli.main -r https://github.com/eli64s/readme-ai

</details> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

Testing

The pytest and nox frameworks are used for development and testing.

Install the dependencies with uv:

❯ uv pip install --dev --group test --all-extras

Run the unit test suite using Pytest:

❯ make test

Using nox, test the app against Python versions 3.10, 3.11, 3.12, and 3.13:

❯ make test-nox

[!TIP] <sub>Nox is an automation tool for testing applications in multiple environments. This helps ensure your project is compatible with across Python versions and environments.</sub>

Configuration

Customize your README generation with a variety of options and style settings supported such as:

Option	Description	Default
`--align`	Text alignment in header	`center`
`--api`	LLM API service provider	`offline`
`--badge-color`	Badge color name or hex code	`0080ff`
`--badge-style`	Badge icon style type	`flat`
`--header-style`	Header template style	`classic`
`--navigation-style`	Table of contents style	`bullet`
`--emojis`	Emoji theme packs prefixed to section titles	`None`
`--logo`	Project logo image	`blue`
`--logo-size`	Logo image size	`30%`
`--model`	Specific LLM model to use	`gpt-3.5-turbo`
`--output`	Output filename	`readme-ai.md`
`--repository`	Repository URL or local directory path	`None`
`--temperature`	Creativity level for content generation	`0.1`
`--tree-max-depth`	Maximum depth of the directory tree structure	`2`

Run the following command to view all available options:

❯ readmeai --help

<sub>

Visit the Official Documentation for a complete guide on configuring and customizing README files.

</sub> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

Example Gallery

This gallery showcases a diverse collection of README examples generated across various programming languages, frameworks, and project types.

Tech	Repository	README	Project Description
Python	README-Python.md	readmeai	ReadmeAI's core project
Apache Flink	README-Flink.md	pyflink-poc	PyFlink proof of concept
Streamlit	README-Streamlit.md	readmeai-streamlit	Web application interface
Vercel & NPM	README-Vercel.md	github-readme-quotes	Deployment showcase
Go & Docker	README-DockerGo.md	docker-gs-ping	Containerized Golang app
FastAPI & Redis	README-FastAPI.md	async-ml-inference	ML inference service
Java	README-Java.md	minimal-todo	Minimalist To-Do app
PostgreSQL & DuckDB	README-PostgreSQL.md	buenavista	Database proxy server
Kotlin	README-Kotlin.md	android-client	Mobile client application
Offline Mode	README-Offline.md	litellm	Offline functionality demo

Community Contribution

Share Your README Files

We invite developers to share their generated README files in our Show & Tell discussion category. Your contributions help:

Showcase diverse documentation styles
Provide real-world examples
Help improve the ReadmeAI tool

Find additional README examples in our examples directory on GitHub.

Roadmap

Release readmeai 1.0.0 with robust documentation creation and maintenance capabilities.
Extend template support for various project types and programming languages.
Develop Vscode Extension to generate README files directly in the editor.
Develop GitHub Actions to automate documentation updates.
Add badge packs to provide additional badge styles and options.
- Code coverage, CI/CD status, project version, and more.

Contributing

Contributions are welcome! Please read the Contributing Guide to get started.

💡 Contributing Guide: Learn about our contribution process and coding standards.
🐛 Report an Issue: Found a bug? Let us know!
💬 Start a Discussion: Have ideas or suggestions? We'd love to hear from you.

Acknowledgments

A big shoutout to the projects below for their awesome work and open-source contributions:

🎗 License

</div> <img src="https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg" alt="line break" width="100%" height="3px">

Readme AI alternatives

View more →

Similar ai agents in Content & Writing, ranked by GitHub stars. Compare licence, recent activity and scan status before you choose.

Name	Stars	Licence	Last updated	Scan
Readme AI (this page) eli64s	3k	MIT	Oct 28, 2026	Scanned, no flagged issues
Siyuan siyuan-note	47k	AGPL-3.0	Nov 1, 2026	Scanned, no flagged issues
Oh Story Claudecode zenstory-ai	8.2k	MIT	Nov 1, 2026	Scanned, no flagged issues
LocalMiniDrama xuanyustudio	2.3k	MIT	Oct 30, 2026	Scanned, no flagged issues
Openclaw Docs yeuxuan	752	None found	Oct 8, 2026	Not scanned yet
Open AI Micro Drama Generator Anil-matcha	555	None found	Aug 2, 2026	Not scanned yet