Skip to main content

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 😀

  • 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 😅

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

pip install GPT4Readability==0.1.5

Dependencies 😇

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 😃

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 🔥

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 😊

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

Support ⚡

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

License 📂

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

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

Metadata

Release files for GPT4Readability 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for GPT4Readability 0.1.5
File Size Uploaded
GPT4Readability-0.1.5.tar.gz 14.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for GPT4Readability 0.1.5
File Interpreter ABI Platform
GPT4Readability-0.1.5-py3-none-any.whl Python 3 none any Details

Total release size: 31.3 kB

Release files / GPT4Readability-0.1.5.tar.gz

Download URL GPT4Readability-0.1.5.tar.gz
Size 14.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b0287d9016a8ce5e0f5cf3b3970ba092124837dbda677468bf815642dd173429
BLAKE2b-256 checksum
How to use checksums
83b4b715567bca2f228e16d2d8e889d153a2eb2603899037df25b705c6a53c5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.18

Release files / GPT4Readability-0.1.5-py3-none-any.whl

Download URL GPT4Readability-0.1.5-py3-none-any.whl
Size 17.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
87b0845c0e293888aabe5974a841ab2b902333d73c59b195d4ab2096cafb21ad
BLAKE2b-256 checksum
How to use checksums
8bec711dec543adc10812ed72093f2019f7a2cada7d3c4b960afd1fb4d938eb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.18

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page