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.4.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.4-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: readmecraft-0.1.4.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.4.tar.gz
Algorithm Hash digest
SHA256 ca12ab77238af608a3a47a9b06662d84809333af030dc05c74dda69e80833a48
MD5 d2934b879f24885b6b695a7b5fa87897
BLAKE2b-256 c92841becd1b695759b266e119f59a75f735b6828bf899b5597e07c8af740556

See more details on using hashes here.

File details

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

File metadata

  • Download URL: readmecraft-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 9.9 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 557e5db79a4144ca842f7bbf93cfe3240ccea2ab6aa2bb71854ce49f45d7717d
MD5 85d406cb5f32ac5cb6ec707f52cdbb1c
BLAKE2b-256 c242477f40b5d9713b741a23c21b2dc919f8190d6ee8d6757c49f675f5c24d4b

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