Skip to main content

A tool to automatically generate README files for your projects.

Project description

ReadmeCraft

An automated README.md generator for your projects
Explore the docs » · Report Bug · Request Feature


About The Project

ReadmeCraft is a powerful tool that automatically generates professional README.md files for your projects. It analyzes your project structure, dependencies, and scripts to create comprehensive documentation with minimal effort. The tool integrates with LLMs (Large Language Models) to generate meaningful descriptions and even creates placeholder logos for your projects.

Built With

  • Python
  • OpenAI API (for LLM integration)
  • Rich (for console formatting)
  • DrawSVG (for logo generation)

Getting Started

Prerequisites

  • Python 3.7+
  • OpenAI API key (if using LLM features)
  • Git (for repository information extraction)

Installation

  1. Clone the repository
    git clone https://github.com/370025263/auto_readme.git
    
  2. Install dependencies
    pip install -e .
    

Usage

Run the following command in your project directory:

python -m readmecraft

The tool will:

  1. Analyze your project structure
  2. Generate descriptions for your scripts
  3. Create a professional README.md file
  4. Optionally generate a project logo

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

@virtueOre91 - m370025263@gmail.com

Project Link: https://github.com/370025263/auto_readme

Acknowledgments

(back to top)

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

readmecraft-0.1.1.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

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

readmecraft-0.1.1-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file readmecraft-0.1.1.tar.gz.

File metadata

  • Download URL: readmecraft-0.1.1.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for readmecraft-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c8632c3535b4e52cf407d5cad564775c8da8b03d9faf04cde0c9fdbc195b662e
MD5 2ed369f8c98f72ff1463e7268f8eb17a
BLAKE2b-256 31324e3c1ed39936254896f002c510503d5cb940bf7f97789ffe31545af8dc38

See more details on using hashes here.

File details

Details for the file readmecraft-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: readmecraft-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.22

File hashes

Hashes for readmecraft-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 69735db23c2d8aaf2a6b43983b773d752f2b45d8a9799da5f2de5c6e272187e8
MD5 61caec9aee0739356c5d9be87d006a70
BLAKE2b-256 e1f8cf0f4998982cef8f12d2c1f660b47da08bdf5f1ac64acd9d535d55679bfa

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