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

Uploaded Python 3

File details

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

File metadata

  • Download URL: readmecraft-0.1.3.tar.gz
  • Upload date:
  • Size: 10.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.3.tar.gz
Algorithm Hash digest
SHA256 705e1d088bff8dd4666fd72acc96373c2c9cc4e3d3359918fd7934109530c627
MD5 9cc080f5c665c06efbc69e7f20af4c1a
BLAKE2b-256 342cafa508ee50059e0699df41ff13e5022dc0f7349837d6a140eec6a17efc09

See more details on using hashes here.

File details

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

File metadata

  • Download URL: readmecraft-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bf97cc23231b94002a4fcf1fe9577ac950d60e6c75c5704b7dee340e510e88cf
MD5 b7e5f06204900ca5dda81177e5323b88
BLAKE2b-256 8f98b32b2b5b152cd330a7efbfabd5b5393c2d11262828a32009a221f9a2757b

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