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
- Clone the repository
git clone https://github.com/370025263/auto_readme.git
- Install dependencies
pip install -e .
Usage
Run the following command in your project directory:
python -m readmecraft
The tool will:
- Analyze your project structure
- Generate descriptions for your scripts
- Create a professional README.md file
- 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.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - 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
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
705e1d088bff8dd4666fd72acc96373c2c9cc4e3d3359918fd7934109530c627
|
|
| MD5 |
9cc080f5c665c06efbc69e7f20af4c1a
|
|
| BLAKE2b-256 |
342cafa508ee50059e0699df41ff13e5022dc0f7349837d6a140eec6a17efc09
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf97cc23231b94002a4fcf1fe9577ac950d60e6c75c5704b7dee340e510e88cf
|
|
| MD5 |
b7e5f06204900ca5dda81177e5323b88
|
|
| BLAKE2b-256 |
8f98b32b2b5b152cd330a7efbfabd5b5393c2d11262828a32009a221f9a2757b
|