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 details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

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

Uploaded Python 3

File details

Details for the file GPT4Readability-0.1.5.tar.gz.

File metadata

  • Download URL: GPT4Readability-0.1.5.tar.gz
  • Upload date:
  • Size: 14.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for GPT4Readability-0.1.5.tar.gz
Algorithm Hash digest
SHA256 b0287d9016a8ce5e0f5cf3b3970ba092124837dbda677468bf815642dd173429
MD5 daa15747326f54ef702d47d8ff8bdc20
BLAKE2b-256 83b4b715567bca2f228e16d2d8e889d153a2eb2603899037df25b705c6a53c5e

See more details on using hashes here.

File details

Details for the file GPT4Readability-0.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for GPT4Readability-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 87b0845c0e293888aabe5974a841ab2b902333d73c59b195d4ab2096cafb21ad
MD5 f9eeb046485a8a607061463f6e0603a8
BLAKE2b-256 8bec711dec543adc10812ed72093f2019f7a2cada7d3c4b960afd1fb4d938eb3

See more details on using hashes here.

Supported by

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