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

Uploaded Python 3

File details

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

File metadata

  • Download URL: readmecraft-0.1.5.tar.gz
  • Upload date:
  • Size: 10.7 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.5.tar.gz
Algorithm Hash digest
SHA256 43bf1d3a94a3d29409df8d50e0632127b382afb0c7d02a7276ffb8fb01dcbd0c
MD5 cb712264c757c0e0aa91483fa2071ade
BLAKE2b-256 7dcdc68bbf5f79774624de33e274ab3e886f8815717c279de21faccff4083666

See more details on using hashes here.

File details

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

File metadata

  • Download URL: readmecraft-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 11.4 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 ebeac18808af49414fff02f6ad9ec131d119b44f36114baed49a6857a6b48b78
MD5 16e65375a4b396024fc7dabead9c8bef
BLAKE2b-256 e35527aa123558c62f7520b34df24631d4de24352438ab10cb5ee1e0038cc8fd

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