<div align="center">
<h1 align="center">
<img src="https://img.icons8.com/?size=512&id=55494&format=png" width="80"/>
<img src="https://img.icons8.com/?size=512&id=kTuxVYRKeKEY&format=png" width="80"/>
<br>README-AI
</h1>
<h3>◦ Generate beautiful and informative README documents.</h3>
<h3>◦ Developed with OpenAI's GPT language model APIs.</h3>
<br>
<p align="center">
<img src="https://img.shields.io/badge/Markdown-000000.svg?stylee&logo=Markdown&logoColor=white" alt="Markdown" />
<img src="https://img.shields.io/badge/OpenAI-412991.svg?stylee&logo=OpenAI&logoColor=white" alt="OpenAI" />
<img src="https://img.shields.io/badge/Python-3776AB.svg?stylee&logo=Python&logoColor=white" alt="Python" />
<img src="https://img.shields.io/badge/Pytest-0A9EDC.svg?stylee&logo=Pytest&logoColor=white" alt="pytest" />
<img src="https://img.shields.io/badge/GNU%20Bash-4EAA25.svg?stylee&logo=GNU-Bash&logoColor=white" alt="Bash" />
<img src="https://img.shields.io/badge/Anaconda-44A833.svg?&logo=Anaconda&logoColor=white" alt="Anaconda" />
</p>
</div>
---
## 📒 Table of Contents
- [📒 Table of Contents](#-table-of-contents)
- [💫 Overview](#-overview)
- [🎯 *Motivation*](#-motivation)
- [⚠️ *Disclaimer*](#️-disclaimer)
- [👾 Demo](#-demo)
- [⚙️ Features](#️-features)
- [🚀 Getting Started](#-getting-started)
- [✔️ Dependencies](#️-dependencies)
- [📂 Repository](#-repository)
- [🔐 OpenAI API Setup](#-openai-api-setup)
- [💻 Installation](#-installation)
- [🎮 Using README-AI](#-using-readme-ai)
- [🧪 Running Tests](#-running-tests)
- [🛠 Future Development](#-future-development)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license)
- [👏 Acknowledgments](#-acknowledgments)
---
## 💫 Overview
README-AI is a powerful, user-friendly command-line tool that generates extensive README markdown documents for your software and data projects. By providing a remote repository URL or directory path to your codebase, this tool will document your entire project, leveraging the capabilities of large language models and OpenAI's GPT APIs.
#### 🎯 *Motivation*
Simplifies the process of writing and maintaining high-quality project documentation. My aim for this project is to provide all skill levels a tool that improves their technical workflow, in an efficient and user-friendly manner. Ultimately, the goal of README-AI is to improve the adoption and usability of open-source projects, enabling everyone to better understand and use open-source tools.
#### ⚠️ *Disclaimer*
README-AI is currently under development and has an opinionated configuration and setup. While this tool provides an excellent starting point for documentation, its important to review all text generated by the OpenAI API to ensure it accurately represents your codebase. Ensure all content in your repository is free of sensitive information before executing.
Additionally, regularly monitor your API usage and costs by visiting the [OpenAI API Usage](https://platform.openai.com/account/usage).
---
## 👾 Demo
[](https://youtu.be/0wbgjL0FMxY)
---
## ⚙️ Features
<h1 align="center">1.<br>👇<br><br>📑 Codebase Documentation</h1>
<table>
<tr>
<td>
<h3>◦ Repository File Summaries</h3>
<ul>
<li>Code summaries are generated for each file via OpenAI's <i>gpt-3.5-turbo</i> engine.</li>
<li>Summaries are processed to check formatting and displayed in Markdown tables.</li>
</ul>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/modules.png" alt="docs">
</td>
</tr>
</table>
<h1 align="center">⒉<br>👇<br><br>🎖 Badges</h1>
<table>
<tr>
<td>
<h3>📍 Introduction, Badges, Table of Contents</h3>
<ul>
<li>The OpenAI API is prompted to create a 1-sentence phrase describing your project.</li>
<li>Project dependencies and metadata are visualized using <a href="https://shields.io/">Shields.io</a> badges.</li>
<li>Badges are sorted by hex code, displayed from light to dark hues.</li>
</ul>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/header.png" alt="docs">
</td>
</tr>
</table>
<h1 align="center">⒊<br>👇<br><br>🧚 Prompted Text Generation</h1>
<table>
<tr>
<td>
<h3>📍 Features Table & Overview</h3>
<ul>
<li>Detailed prompts are embedded with repository metadata and passed to the OpenAI API.</li>
<ul>
<li><em>Features</em> table highlights various technical attributes of your codebase.
</li>
<li><em>Overview</em> section describes your project's use case and applications.
</li>
</ul>
</ul>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/features.png" alt="features">
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/overview.png" alt="overview">
</td>
</tr>
</table>
<h1 align="center">⒋<br>👇<br><br>🌲 Repository Tree</h1>
<table>
<tr>
<td>
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/tree.png" alt="tree">
</td>
</tr>
</table>
<h1 align="center">⒌<br>👇<br><br>📦 Dynamic User Setup Guides</h1>
<table>
<tr>
<td>
<h3><b>📍 Installation, Usage, and Running Tests</b></h3>
<ul>
<li>Generates instructions for installing, using, and testing your codebase.</li>
<li>README-AI currently supports this feature for code written with:</li>
<ul>
<li>
<i>Python, Rust, Go, C, Kotlin, Java, JavaScript, TypeScript.</i>
</li>
</ul>
</ul>
</td>
</tr>
<tr>
<td>
<img src="https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/getting_started.png" alt="getting_started">
</td>
</tr>
</table>
<h1 align="center">⒍<br>👇<br><br>👩💻Contributing Guidelines & more!</h1>
| |
|-----------------------------------------------|
|  |
<h1 align="center">⒎<br>👇<br><br>💥 Example Files</h1>
<p align="center">Markdown example files generated by the README-AI app!</p>
<div align="center">
<table align="center">
<tr>
<th></th>
<th>Example File</th>
<th>Repository</th>
<th>Language</th>
<th>Bytes</th>
</tr>
<tr>
<td>1️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-python.md">readme-python.md</a></td>
<td><a href="https://github.com/eli64s/readme-ai">readme-ai</a></td>
<td>Python</td>
<td>
<p>19,839</p>
</tr>
<td>2️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-typescript.md">readme-typescript.md</a></td>
<td><a href="https://github.com/Yuberley/ChatGPT-App-React-Native-TypeScript">chatgpt-app-react-typescript</a></td>
<td>TypeScript, React</td>
<td>
<p>988</p>
</tr>
<tr>
<td>3️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-javascript.md">readme-javascript.md</a></td>
<td><a href="https://github.com/idosal/assistant-chat-gpt">assistant-chat-gpt-javascript</a></td>
<td>JavaScript, React</td>
<td>
<p>212</p>
</tr>
<tr>
<td>4️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-kotlin.md">readme-kotlin.md</a></td>
<td><a href="https://github.com/rumaan/file.io-Android-Client">file.io-android-client</a></td>
<td>Kotlin, Java, Android</td>
<td>
<p>113,649</p>
</tr>
<tr>
<td>5️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-rust-c.md">readme-rust-c.md</a></td>
<td><a href="https://github.com/DownWithUp/CallMon">rust-c-app</a></td>
<td>C, Rust</td>
<td>
<p>72</p>
</tr>
<tr>
<td>6️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-go.md">readme-go.md</a></td>
<td><a href="https://github.com/olliefr/docker-gs-ping">go-docker-app</a></td>
<td>Go</td>
<td>
<p>41</p>
</tr>
<tr>
<td>7️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-java.md">readme-java.md</a></td>
<td><a href="https://github.com/avjinder/Minimal-Todo">java-minimal-todo</a></td>
<td>Java</td>
<td>
<p>17,725</p>
</tr>
<tr>
<td>8️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-fastapi-redis.md">readme-fastapi-redis.md</a></td>
<td><a href="https://github.com/FerrariDG/async-ml-inference">async-ml-inference</a></td>
<td>Python, FastAPI, Redis</td>
<td>
<p>355</p>
</tr>
<tr>
<td>9️⃣</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-mlops.md">readme-mlops.md</a></td>
<td><a href="https://github.com/GokuMohandas/mlops-course">mlops-course</a></td>
<td>Python, Jupyter</td>
<td>
<p>8,524</p>
</tr>
<tr>
<td>🔟</td>
<td><a href="https://github.com/eli64s/readme-ai/blob/main/examples/readme-pyflink.md">readme-pyflink.md</a></td>
<td><a href="https://github.com/eli64s/flink-flow">flink-flow</a></td>
<td>PyFlink</td>
<td>
<p>32</p>
</tr>
</table>
</div>
<h1 align="center">⒏<br>👇<br><br>📜 Custom README template formats coming soon!</h1>
<p align="center">Developing a feature that allows users to select from a variety of README formats and styles.</p>
<p align="center">Custom templates will be tailored for use-cases such as data, ai & ml, research, minimal, and more!</p>
<p align="right">
<a href="#top"><b>🔝 Return </b></a>
</p>
---
## 🚀 Getting Started
### ✔️ Dependencies
Before you begin, ensure that you have the following prerequisites installed:
- Python 3.8 or higher
- Conda package manager (recommended)
- Access to the OpenAI API (see the setup guide below)
#### 📂 Repository
Most user's will run README-AI using the command-line interface, specifying their repository on run-time. However, if you would like to use the default configuration, you will need to update the [configuration file](./conf/conf.toml) with your repository's remote URL (GitHub, GitLab) or local directory pat on your machine.
```toml
# Repository Configuration
[git]
repository = "INSERT YOUR REPOSITORY URL / LOCAL DIRECTORY"
```
#### 🔐 OpenAI API Setup
To use the README-AI application, you will need to create an account with OpenAI to generate an API key. The steps below outline this setup process:
<details closed><summary>OpenAI API User Guide</summary>
1. Go to the [OpenAI website](https://platform.openai.com/).
2. Click the "Sign up for free" button.
3. Fill out the registration form with your information and agree to the terms of service.
4. Once logged in, click on the "API" tab.
5. Follow the instructions to create a new API key.
6. Copy the API key and keep it in a secure place.
</details>
<br>
> ⚠️ **Note:**
>
> - To maximize your experience with README-AI, it is recommended to set up a payment method on OpenAI's website. By doing so, you gain access to more powerful language models like gpt-3.5-turbo. Without a payment method, your usage will be restricted to the base gpt-3 models. This limitation might lead to less precise README files or potential errors during the generation process.
>
> - When using a payment method, make sure you have sufficient credits to run the README-AI application. Additionally, remember to regularly monitor your API usage and costs by visiting the [OpenAI API Usage Dashboard](https://platform.openai.com/account/usage). Please note that this API is not free and you will be charged for each request made, which can accumulate rapidly.
>
> - The generation of the README.md file should typically complete in under 1 minute. If it takes longer than a few minutes, please terminate the process.
>
---
### 💻 Installation
1. Clone the README-AI repository to your local machine.
```sh
git clone https://github.com/eli64s/README-AI
```
2. Navigate to the README-AI directory.
```sh
cd README-AI
```
3. Use one of the following methods to install the required dependencies:
```sh
# With Bash
$ bash setup/setup.sh
```
```sh
# With Conda
$ conda env create -f setup/environment.yaml
$ conda activate readme_ai
$ pip install -r requirements.txt
```
```sh
# With Poetry
$ poetry install
```
```sh
# With Docker
$ docker pull zeroxeli/readme-ai:v0.1.0
```
### 🎮 Using README-AI
Use the command-line to provide the OpenAI API key (if not already set) and specify an output path for your README file, along with the path to your local repository or remote code repository. You can also provide the output path in the [configuration file](./conf/conf.toml)
Command-Line Arguments:
- `-k` or `--api-key`: Your OpenAI API key.
- `-o` or `--output`: The output path for your README.md file.
- `-r` or `--repository`: The URL or path to your code repository.
- `-t` or `--template`: The README template format to use. (Coming soon!)
```sh
python src/main.py --api-key abc123 --output readme-ai.md --repository https://github.com/eli64s/readme-ai
```
Alternatively, export your OpenAI API key as an environment variable and run the following command:
```sh
conda activate readme_ai
export OPENAI_API_KEY=sk123abc456def7890
python src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai
```
```sh
# With Poetry
poetry shell
export OPENAI_API_KEY=sk123abc456def7890
poetry run python src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai
```
```sh
# Run with Docker
docker run -it -e OPENAI_API_KEY="your-api-key" -v "$(pwd)":/app -w /app zeroxeli/readme-ai:v0.1.0 \
python src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai
```
### 🧪 Running Tests
To run the unit-tests for README-AI, use the following command.
```bash
bash scripts/test.sh
```
<p align="right">
<a href="#top"><b>🔝 Return </b></a>
</p>
---
## 🛠 Future Development
- [X] Add additional language support for populating the *installation*, *usage*, and *test* README sections.
- [ ] Design and implement a variety of README template formats and styles.
- [ ] Add feature to select the output language of the README file (i.e. CN, ES, FR, JA, KO, RU).
- [ ] Create UI with [Textual](https://github.com/Textualize/textual) or another framework to improve user experience.
---
## 🤝 Contributing
[Contributing Guidelines](./CONTRIBUTING.md)
---
## 📄 License
[MIT](./LICENSE)
---
## 👏 Acknowledgments
*Badges*
- [Shields.io](https://shields.io/)
- [Aveek-Saha/GitHub-Profile-Badges](https://github.com/Aveek-Saha/GitHub-Profile-Badges)
- [Ileriayo/Markdown-Badges](https://github.com/Ileriayo/markdown-badges)
<p align="right">
<a href="#top"><b>🔝 Return </b></a>
</p>
---
Raw data
{
"_id": null,
"home_page": "https://github.com/eli64s/README-AI",
"name": "readme-ai",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "markdown,readme,readme-badges,documentation-generator,markdown-generator,automated-documentation,awesome-readme,readme-generator,python-ai,gpt-3,openai-api,shieldsio-badges,gpt-4,llms,openai-python,chatgpt-python,llmops,openai-chatbot,gpt-35-turbo",
"author": "Eli",
"author_email": "43382407+eli64s@users.noreply.github.com",
"download_url": "https://files.pythonhosted.org/packages/c0/52/86657df4aa8e9ca68a9c2ec8480c46fba8f69e96bc7571dabb271d5d1c67/readme_ai-0.0.700.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <h1 align=\"center\">\n <img src=\"https://img.icons8.com/?size=512&id=55494&format=png\" width=\"80\"/>\n <img src=\"https://img.icons8.com/?size=512&id=kTuxVYRKeKEY&format=png\" width=\"80\"/>\n <br>README-AI\n </h1>\n <h3>\u25e6 Generate beautiful and informative README documents.</h3>\n <h3>\u25e6 Developed with OpenAI's GPT language model APIs.</h3>\n <br>\n <p align=\"center\">\n <img src=\"https://img.shields.io/badge/Markdown-000000.svg?stylee&logo=Markdown&logoColor=white\" alt=\"Markdown\" />\n <img src=\"https://img.shields.io/badge/OpenAI-412991.svg?stylee&logo=OpenAI&logoColor=white\" alt=\"OpenAI\" />\n <img src=\"https://img.shields.io/badge/Python-3776AB.svg?stylee&logo=Python&logoColor=white\" alt=\"Python\" />\n <img src=\"https://img.shields.io/badge/Pytest-0A9EDC.svg?stylee&logo=Pytest&logoColor=white\" alt=\"pytest\" />\n <img src=\"https://img.shields.io/badge/GNU%20Bash-4EAA25.svg?stylee&logo=GNU-Bash&logoColor=white\" alt=\"Bash\" />\n <img src=\"https://img.shields.io/badge/Anaconda-44A833.svg?&logo=Anaconda&logoColor=white\" alt=\"Anaconda\" />\n </p>\n\n \n \n \n \n</div>\n\n---\n\n## \ud83d\udcd2 Table of Contents\n\n- [\ud83d\udcd2 Table of Contents](#-table-of-contents)\n- [\ud83d\udcab Overview](#-overview)\n - [\ud83c\udfaf *Motivation*](#-motivation)\n - [\u26a0\ufe0f *Disclaimer*](#\ufe0f-disclaimer)\n- [\ud83d\udc7e Demo](#-demo)\n- [\u2699\ufe0f Features](#\ufe0f-features)\n- [\ud83d\ude80 Getting Started](#-getting-started)\n - [\u2714\ufe0f Dependencies](#\ufe0f-dependencies)\n - [\ud83d\udcc2 Repository](#-repository)\n - [\ud83d\udd10 OpenAI API Setup](#-openai-api-setup)\n - [\ud83d\udcbb Installation](#-installation)\n - [\ud83c\udfae Using README-AI](#-using-readme-ai)\n - [\ud83e\uddea Running Tests](#-running-tests)\n- [\ud83d\udee0 Future Development](#-future-development)\n- [\ud83e\udd1d Contributing](#-contributing)\n- [\ud83d\udcc4 License](#-license)\n- [\ud83d\udc4f Acknowledgments](#-acknowledgments)\n\n---\n\n## \ud83d\udcab Overview\n\nREADME-AI is a powerful, user-friendly command-line tool that generates extensive README markdown documents for your software and data projects. By providing a remote repository URL or directory path to your codebase, this tool will document your entire project, leveraging the capabilities of large language models and OpenAI's GPT APIs.\n\n#### \ud83c\udfaf *Motivation*\n\nSimplifies the process of writing and maintaining high-quality project documentation. My aim for this project is to provide all skill levels a tool that improves their technical workflow, in an efficient and user-friendly manner. Ultimately, the goal of README-AI is to improve the adoption and usability of open-source projects, enabling everyone to better understand and use open-source tools.\n#### \u26a0\ufe0f *Disclaimer*\n\nREADME-AI is currently under development and has an opinionated configuration and setup. While this tool provides an excellent starting point for documentation, its important to review all text generated by the OpenAI API to ensure it accurately represents your codebase. Ensure all content in your repository is free of sensitive information before executing.\n\nAdditionally, regularly monitor your API usage and costs by visiting the [OpenAI API Usage](https://platform.openai.com/account/usage).\n\n---\n\n## \ud83d\udc7e Demo\n\n[](https://youtu.be/0wbgjL0FMxY)\n\n---\n\n\n## \u2699\ufe0f Features\n\n<h1 align=\"center\">1.<br>\ud83d\udc47<br><br>\ud83d\udcd1 Codebase Documentation</h1>\n<table>\n <tr>\n <td>\n <h3>\u25e6 Repository File Summaries</h3>\n <ul>\n <li>Code summaries are generated for each file via OpenAI's <i>gpt-3.5-turbo</i> engine.</li>\n <li>Summaries are processed to check formatting and displayed in Markdown tables.</li>\n </ul>\n </td>\n </tr>\n <tr>\n <td>\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/modules.png\" alt=\"docs\">\n </td>\n </tr>\n</table>\n\n<h1 align=\"center\">\u2489<br>\ud83d\udc47<br><br>\ud83c\udf96 Badges</h1>\n<table>\n <tr>\n <td>\n <h3>\ud83d\udccd Introduction, Badges, Table of Contents</h3>\n <ul>\n <li>The OpenAI API is prompted to create a 1-sentence phrase describing your project.</li>\n <li>Project dependencies and metadata are visualized using <a href=\"https://shields.io/\">Shields.io</a> badges.</li>\n <li>Badges are sorted by hex code, displayed from light to dark hues.</li>\n </ul>\n </td>\n </tr>\n <tr>\n <td>\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/header.png\" alt=\"docs\">\n </td>\n </tr>\n</table>\n\n<h1 align=\"center\">\u248a<br>\ud83d\udc47<br><br>\ud83e\uddda Prompted Text Generation</h1>\n<table>\n <tr>\n <td>\n <h3>\ud83d\udccd Features Table & Overview</h3>\n <ul>\n <li>Detailed prompts are embedded with repository metadata and passed to the OpenAI API.</li>\n <ul>\n <li><em>Features</em> table highlights various technical attributes of your codebase.\n </li>\n <li><em>Overview</em> section describes your project's use case and applications.\n </li>\n </ul>\n </ul>\n </td>\n </tr>\n <tr>\n <td>\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/features.png\" alt=\"features\">\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/overview.png\" alt=\"overview\">\n </td>\n </tr>\n</table>\n\n<h1 align=\"center\">\u248b<br>\ud83d\udc47<br><br>\ud83c\udf32 Repository Tree</h1>\n<table>\n <tr>\n <td>\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/tree.png\" alt=\"tree\">\n </td>\n </tr>\n</table>\n\n<h1 align=\"center\">\u248c<br>\ud83d\udc47<br><br>\ud83d\udce6 Dynamic User Setup Guides</h1>\n<table>\n <tr>\n <td>\n <h3><b>\ud83d\udccd Installation, Usage, and Running Tests</b></h3>\n <ul>\n <li>Generates instructions for installing, using, and testing your codebase.</li>\n <li>README-AI currently supports this feature for code written with:</li>\n <ul>\n <li>\n <i>Python, Rust, Go, C, Kotlin, Java, JavaScript, TypeScript.</i>\n </li>\n </ul>\n </ul>\n </td>\n </tr>\n <tr>\n <td>\n <img src=\"https://raw.githubusercontent.com/eli64s/README-AI/main/examples/imgs/getting_started.png\" alt=\"getting_started\">\n </td>\n </tr>\n</table>\n\n<h1 align=\"center\">\u248d<br>\ud83d\udc47<br><br>\ud83d\udc69\u200d\ud83d\udcbbContributing Guidelines & more!</h1>\n\n| |\n|-----------------------------------------------|\n|  |\n\n<h1 align=\"center\">\u248e<br>\ud83d\udc47<br><br>\ud83d\udca5 Example Files</h1>\n<p align=\"center\">Markdown example files generated by the README-AI app!</p>\n<div align=\"center\">\n <table align=\"center\">\n <tr>\n <th></th>\n <th>Example File</th>\n <th>Repository</th>\n <th>Language</th>\n <th>Bytes</th>\n </tr>\n <tr>\n <td>1\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-python.md\">readme-python.md</a></td>\n <td><a href=\"https://github.com/eli64s/readme-ai\">readme-ai</a></td>\n <td>Python</td>\n <td>\n <p>19,839</p>\n </tr>\n <td>2\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-typescript.md\">readme-typescript.md</a></td>\n <td><a href=\"https://github.com/Yuberley/ChatGPT-App-React-Native-TypeScript\">chatgpt-app-react-typescript</a></td>\n <td>TypeScript, React</td>\n <td>\n <p>988</p>\n </tr>\n <tr>\n <td>3\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-javascript.md\">readme-javascript.md</a></td>\n <td><a href=\"https://github.com/idosal/assistant-chat-gpt\">assistant-chat-gpt-javascript</a></td>\n <td>JavaScript, React</td>\n <td>\n <p>212</p>\n </tr>\n <tr>\n <td>4\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-kotlin.md\">readme-kotlin.md</a></td>\n <td><a href=\"https://github.com/rumaan/file.io-Android-Client\">file.io-android-client</a></td>\n <td>Kotlin, Java, Android</td>\n <td>\n <p>113,649</p>\n </tr>\n <tr>\n <td>5\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-rust-c.md\">readme-rust-c.md</a></td>\n <td><a href=\"https://github.com/DownWithUp/CallMon\">rust-c-app</a></td>\n <td>C, Rust</td>\n <td>\n <p>72</p>\n </tr>\n <tr>\n <td>6\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-go.md\">readme-go.md</a></td>\n <td><a href=\"https://github.com/olliefr/docker-gs-ping\">go-docker-app</a></td>\n <td>Go</td>\n <td>\n <p>41</p>\n </tr>\n <tr>\n <td>7\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-java.md\">readme-java.md</a></td>\n <td><a href=\"https://github.com/avjinder/Minimal-Todo\">java-minimal-todo</a></td>\n <td>Java</td>\n <td>\n <p>17,725</p>\n </tr>\n <tr>\n <td>8\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-fastapi-redis.md\">readme-fastapi-redis.md</a></td>\n <td><a href=\"https://github.com/FerrariDG/async-ml-inference\">async-ml-inference</a></td>\n <td>Python, FastAPI, Redis</td>\n <td>\n <p>355</p>\n </tr>\n <tr>\n <td>9\ufe0f\u20e3</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-mlops.md\">readme-mlops.md</a></td>\n <td><a href=\"https://github.com/GokuMohandas/mlops-course\">mlops-course</a></td>\n <td>Python, Jupyter</td>\n <td>\n <p>8,524</p>\n </tr>\n <tr>\n <td>\ud83d\udd1f</td>\n <td><a href=\"https://github.com/eli64s/readme-ai/blob/main/examples/readme-pyflink.md\">readme-pyflink.md</a></td>\n <td><a href=\"https://github.com/eli64s/flink-flow\">flink-flow</a></td>\n <td>PyFlink</td>\n <td>\n <p>32</p>\n </tr>\n </table>\n</div>\n\n\n<h1 align=\"center\">\u248f<br>\ud83d\udc47<br><br>\ud83d\udcdc Custom README template formats coming soon!</h1>\n<p align=\"center\">Developing a feature that allows users to select from a variety of README formats and styles.</p>\n<p align=\"center\">Custom templates will be tailored for use-cases such as data, ai & ml, research, minimal, and more!</p>\n\n<p align=\"right\">\n <a href=\"#top\"><b>\ud83d\udd1d Return </b></a>\n</p>\n\n---\n\n## \ud83d\ude80 Getting Started\n\n### \u2714\ufe0f Dependencies\n\nBefore you begin, ensure that you have the following prerequisites installed:\n\n- Python 3.8 or higher\n- Conda package manager (recommended)\n- Access to the OpenAI API (see the setup guide below)\n\n#### \ud83d\udcc2 Repository\n\nMost user's will run README-AI using the command-line interface, specifying their repository on run-time. However, if you would like to use the default configuration, you will need to update the [configuration file](./conf/conf.toml) with your repository's remote URL (GitHub, GitLab) or local directory pat on your machine.\n\n```toml\n# Repository Configuration\n[git]\nrepository = \"INSERT YOUR REPOSITORY URL / LOCAL DIRECTORY\"\n```\n\n#### \ud83d\udd10 OpenAI API Setup\n\nTo use the README-AI application, you will need to create an account with OpenAI to generate an API key. The steps below outline this setup process:\n\n<details closed><summary>OpenAI API User Guide</summary>\n\n1. Go to the [OpenAI website](https://platform.openai.com/).\n2. Click the \"Sign up for free\" button.\n3. Fill out the registration form with your information and agree to the terms of service.\n4. Once logged in, click on the \"API\" tab.\n5. Follow the instructions to create a new API key.\n6. Copy the API key and keep it in a secure place.\n\n</details>\n<br>\n\n> \u26a0\ufe0f **Note:**\n>\n> - To maximize your experience with README-AI, it is recommended to set up a payment method on OpenAI's website. By doing so, you gain access to more powerful language models like gpt-3.5-turbo. Without a payment method, your usage will be restricted to the base gpt-3 models. This limitation might lead to less precise README files or potential errors during the generation process.\n>\n> - When using a payment method, make sure you have sufficient credits to run the README-AI application. Additionally, remember to regularly monitor your API usage and costs by visiting the [OpenAI API Usage Dashboard](https://platform.openai.com/account/usage). Please note that this API is not free and you will be charged for each request made, which can accumulate rapidly.\n>\n> - The generation of the README.md file should typically complete in under 1 minute. If it takes longer than a few minutes, please terminate the process.\n>\n\n---\n\n### \ud83d\udcbb Installation\n\n1. Clone the README-AI repository to your local machine.\n```sh\ngit clone https://github.com/eli64s/README-AI\n```\n\n2. Navigate to the README-AI directory.\n```sh\ncd README-AI\n```\n\n3. Use one of the following methods to install the required dependencies:\n\n```sh\n# With Bash\n$ bash setup/setup.sh\n```\n\n```sh\n# With Conda\n$ conda env create -f setup/environment.yaml\n$ conda activate readme_ai\n$ pip install -r requirements.txt\n```\n\n```sh\n# With Poetry\n$ poetry install\n```\n\n```sh\n# With Docker\n$ docker pull zeroxeli/readme-ai:v0.1.0\n```\n\n### \ud83c\udfae Using README-AI\n\nUse the command-line to provide the OpenAI API key (if not already set) and specify an output path for your README file, along with the path to your local repository or remote code repository. You can also provide the output path in the [configuration file](./conf/conf.toml)\n\nCommand-Line Arguments:\n\n- `-k` or `--api-key`: Your OpenAI API key.\n- `-o` or `--output`: The output path for your README.md file.\n- `-r` or `--repository`: The URL or path to your code repository.\n- `-t` or `--template`: The README template format to use. (Coming soon!)\n\n```sh\npython src/main.py --api-key abc123 --output readme-ai.md --repository https://github.com/eli64s/readme-ai\n```\nAlternatively, export your OpenAI API key as an environment variable and run the following command:\n\n```sh\nconda activate readme_ai\n\nexport OPENAI_API_KEY=sk123abc456def7890\n\npython src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai\n```\n\n```sh\n# With Poetry\npoetry shell\n\nexport OPENAI_API_KEY=sk123abc456def7890\n\npoetry run python src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai\n```\n\n```sh\n# Run with Docker\ndocker run -it -e OPENAI_API_KEY=\"your-api-key\" -v \"$(pwd)\":/app -w /app zeroxeli/readme-ai:v0.1.0 \\\npython src/main.py -o readme-ai.md -r https://github.com/eli64s/readme-ai\n```\n\n### \ud83e\uddea Running Tests\n\nTo run the unit-tests for README-AI, use the following command.\n\n```bash\nbash scripts/test.sh\n```\n\n<p align=\"right\">\n <a href=\"#top\"><b>\ud83d\udd1d Return </b></a>\n</p>\n\n---\n\n## \ud83d\udee0 Future Development\n\n- [X] Add additional language support for populating the *installation*, *usage*, and *test* README sections.\n- [ ] Design and implement a variety of README template formats and styles.\n- [ ] Add feature to select the output language of the README file (i.e. CN, ES, FR, JA, KO, RU).\n- [ ] Create UI with [Textual](https://github.com/Textualize/textual) or another framework to improve user experience.\n\n---\n\n## \ud83e\udd1d Contributing\n\n[Contributing Guidelines](./CONTRIBUTING.md)\n\n---\n\n## \ud83d\udcc4 License\n\n[MIT](./LICENSE)\n\n---\n\n## \ud83d\udc4f Acknowledgments\n\n*Badges*\n - [Shields.io](https://shields.io/)\n - [Aveek-Saha/GitHub-Profile-Badges](https://github.com/Aveek-Saha/GitHub-Profile-Badges)\n - [Ileriayo/Markdown-Badges](https://github.com/Ileriayo/markdown-badges)\n\n<p align=\"right\">\n <a href=\"#top\"><b>\ud83d\udd1d Return </b></a>\n</p>\n\n---\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\ud83d\ude80 Generate awesome README files from the terminal, powered by OpenAI's GPT language model APIs \ud83d\udcab",
"version": "0.0.700",
"project_urls": {
"Documentation": "https://github.com/eli64s/README-AI/blob/main/README.md",
"Homepage": "https://github.com/eli64s/README-AI"
},
"split_keywords": [
"markdown",
"readme",
"readme-badges",
"documentation-generator",
"markdown-generator",
"automated-documentation",
"awesome-readme",
"readme-generator",
"python-ai",
"gpt-3",
"openai-api",
"shieldsio-badges",
"gpt-4",
"llms",
"openai-python",
"chatgpt-python",
"llmops",
"openai-chatbot",
"gpt-35-turbo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "10ac602af449523c84524c797603d37b250a5cf356ce6261e62d9b13d5c4a3d1",
"md5": "7d0dba604b05d41bfa4f12d67626c8b9",
"sha256": "5f57b57ad5f7edfb327333f3f7631549dde9f1b90b4db0d1a98956b5c63a8183"
},
"downloads": -1,
"filename": "readme_ai-0.0.700-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7d0dba604b05d41bfa4f12d67626c8b9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 22297,
"upload_time": "2023-06-22T17:02:00",
"upload_time_iso_8601": "2023-06-22T17:02:00.319868Z",
"url": "https://files.pythonhosted.org/packages/10/ac/602af449523c84524c797603d37b250a5cf356ce6261e62d9b13d5c4a3d1/readme_ai-0.0.700-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c05286657df4aa8e9ca68a9c2ec8480c46fba8f69e96bc7571dabb271d5d1c67",
"md5": "ea33d0190f1546a2a0c9a479af429564",
"sha256": "7a813827509c3e620e539e988946b369752f61f318cc4f903cd870088776d41c"
},
"downloads": -1,
"filename": "readme_ai-0.0.700.tar.gz",
"has_sig": false,
"md5_digest": "ea33d0190f1546a2a0c9a479af429564",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 24432,
"upload_time": "2023-06-22T17:02:01",
"upload_time_iso_8601": "2023-06-22T17:02:01.946992Z",
"url": "https://files.pythonhosted.org/packages/c0/52/86657df4aa8e9ca68a9c2ec8480c46fba8f69e96bc7571dabb271d5d1c67/readme_ai-0.0.700.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-22 17:02:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "eli64s",
"github_project": "README-AI",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "readme-ai"
}
JSON
