Skip to content

datasherlock/helpme-readme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI-Powered README Generator

Screenshot 2024-08-16 at 5 33 47 PM

This repository contains a Python script that automatically generates README.md files for GitHub repositories using Google AI.

Features

  • Clones a given GitHub repository.
  • Merges all code files into a single file for analysis.
  • Sends the merged code to Google AI's Gemini Pro model.
  • Uses a prompt engineered to generate human-like and informative README content.
  • Writes the generated README back to the cloned repository.

Dependencies

  • Python 3.7+
  • gitpython
  • google-cloud-aiplatform
  • vertexai

You can install the necessary packages using:

pip install -r requirements.txt 

Usage

  1. Set up Google Cloud Project and Vertex AI API:

    • Create a Google Cloud Project (https://cloud.google.com/).
    • Enable the Vertex AI API.
    • Create a service account and download its JSON key file.
    • Set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your JSON key file:
      export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
  2. Get Repository URL:

    • Get the repository URL from Github. This should be the complete path with the .git extension
  3. Run the script:

    python helpme_readme.py --repo_url=<Github URL>

The script will generate or update the README.md file in the cloned repository directory.

Disclaimer

  • The quality of the generated README depends on the complexity and clarity of the codebase.
  • This is an experimental tool and may require further refinement or customization.

About

This tool automatically generates README.md files for GitHub repositories using Google AI.

Resources

Stars

Watchers

Forks

Contributors

Languages