Skip to main content

A tool to automatically generate a README.md and suggest code improvements for any code repository. It uses GPT-3, GPT-4, or an optional LocalAI model to generate the README.md and suggestions.

Project description

GPT4Readability

License Badge Issues Badge Pull Requests Badge Contributors Badge contributions welcome

Welcome to GPT4Readability! This tool is designed to automatically generate a README.md and suggest code improvements for any code repository. It uses GPT-3, GPT-4, or an optional LocalAI model to generate the README.md and suggestions.

Other than this sentence this readme file and this suggestions file were both generated by GPT4Readability using gpt-3.5-turbo. Any other changes made will be listed below:

  • I added the version (0.1.5) to the installation section.
  • UPDATE: README generation (suggestions coming soon!) is now integrated into Huggingface Spaces 🤗 using Gradio. Try out the Web Demo: Hugging Face Spaces
  • I recently got access to GPT-4 so the GPT-4 version of the gpt4readability README can be found here GPT-4_Example
  • The README file generation works with all programing languages but for now the code suggestions is still python only.
  • The new local AI is Mixtral-8x7b, this was setup using llamacpp and langchain. The installation process can be found here and you should be able to download any gguf model to try but the ones I found work well can be downloaded from here! A config file for the model setup is located at GPT4Readability/configs/local_ai.yaml and an example of the local AI results can be found in this README.

Main Functionalities :grinning:

  • README Generation: Automatically generates a comprehensive README.md for your code repository.
  • Code Improvement Suggestions: Provides suggestions for improving your code.
  • Support for Multiple Models: Supports GPT-3, GPT-4, and LocalAI models.
  • Large Repository Support: Capable of handling repositories of up to 8300 text segments.

Installation :sweat_smile:

GPT4Readability requires Python 3.6 or higher. You can install it using pip:

pip install GPT4Readability==0.1.5

Dependencies :innocent:

The following packages are required:

  • langchain
  • openai
  • faiss-cpu
  • tiktoken
  • click
  • tqdm
  • unstructured
  • markdown
  • nbconvert
  • typer[all]
  • pyyaml

You can install all dependencies using pip:

pip install langchain openai faiss-cpu tiktoken click tqdm unstructured markdown nbconvert typer[all] pyyaml

Usage :smiley:

You can use GPT4Readability as a command-line tool. Here's an example:

gpt4readability --function readme --output-readme README_Generated.md --model gpt-3.5-turbo

This command will generate a README for the current directory using the GPT-3.5-turbo model and save it as README_Generated.md.

Contributing :fire:

We welcome contributions! Here's how you can help:

  • Reporting Bugs: If you find a bug, please open an issue on GitHub.
  • Pull Requests: If you've fixed a bug or added a new feature, we'd love to see your work! Please submit a pull request.
  • Donations: If you find this tool useful and would like to support its development, you can make a donation. Please email the author for details.

Author :blush:

GPT4Readability is developed by Dennis Johan Loevlie. You can contact him at loevliedenny@gmail.com.

Support :zap:

For commercial support, please contact the author at loevliedenny@gmail.com.

License :open_file_folder:

GPT4Readability is licensed under the MIT License. You can view the license here.

Thank you for using GPT4Readability! We hope you find it useful.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

GPT4Readability-0.1.5.tar.gz (14.2 kB view hashes)

Uploaded Source

Built Distribution

GPT4Readability-0.1.5-py3-none-any.whl (17.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page