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.2.tar.gz (10.0 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.2-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: readmecraft-0.1.2.tar.gz
  • Upload date:
  • Size: 10.0 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.2.tar.gz
Algorithm Hash digest
SHA256 0525475177c11ef13694a06b32a2bfdfda3c2cdefe378700f8bf2d99023498c4
MD5 50ab3f7fa06976d46141f94b0a0ab8af
BLAKE2b-256 4562e3544e18b1fd80b2a51fd0a5d61ede6fffa28bc18099b42434c4ab9b475d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: readmecraft-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c0e72055365ac17ffbbaedb6619066712bfd9beef8a497da5138159ec0c09eb2
MD5 1a05036eeb90b863dd23860a26ebf27b
BLAKE2b-256 bf55b6bc58ba212509aff0a2361d338a24d915b02cb17304551acba155f35436

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