Skip to main content

Generate professional README.md files using AI

Project description

readmegen_cli: Effortless README Generation 📝

🔐 Environment Setup

Create a .env file in the root of your project with:

You can get a Gemini API key from: https://makersuite.google.com/app/apikey

Effortlessly generate professional README files for your projects. readmegen_cli is a command-line tool designed to streamline the process of creating comprehensive and well-structured README files. Tired of manually writing and formatting READMEs? Let readmegen_cli automate the process, allowing you to focus on your code. It intelligently analyzes your project structure and automatically populates key sections, saving you valuable time and effort.

This tool leverages your project's existing files and structure to generate a README that includes essential details such as project description, features, installation instructions, and technology stack. It’s perfect for both small personal projects and large collaborative endeavors. readmegen_cli aims to improve consistency and reduce the cognitive load associated with README creation.

By automating the tedious parts of README creation, readmegen_cli allows developers to focus on what truly matters: building great software. The generated README adheres to best practices, ensuring clarity and professionalism.

Features ✨

  • Automated Generation: Creates a comprehensive README based on your project's structure.
  • Intelligent Analysis: Automatically detects key project information.
  • Customizable Output: Easily adaptable to your specific project needs.
  • Time-Saving: Streamlines the README creation process.
  • Consistent Formatting: Ensures professional and well-structured READMEs.

Installation ⚙️

Install readmegen_cli using pip:

pip install readmegen-cli

Usage 💻

Navigate to your project's root directory in your terminal and run:

readmegen

This will generate a README.md file in your project's root directory. You can then customize the generated file to your liking. For example, to generate a README with a specific title, you can use the --title option:

readmegen --title "My Awesome Project"

Technologies 🛠️

Technology Version
Python 3.7+
Markup Language Markdown (.md)

License 📄

This project is licensed under the MIT License - see the LICENSE file for details. (Note: A LICENSE file should be created separately.)

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

readmegen_cli-0.1.2.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

readmegen_cli-0.1.2-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: readmegen_cli-0.1.2.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.5

File hashes

Hashes for readmegen_cli-0.1.2.tar.gz
Algorithm Hash digest
SHA256 4e8206012c86f3f4df20b1a2f6f4dc763dbdce9f79ba3a54976b0389a1913cda
MD5 364d4e9e6ccb8ebec84b79477b491f1c
BLAKE2b-256 d15df8acb63e6af76189dace4d744808905a148cde938ea62be0da30bf91daaa

See more details on using hashes here.

File details

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

File metadata

  • Download URL: readmegen_cli-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.5

File hashes

Hashes for readmegen_cli-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 59511712bd2c9a634bc4de2e6fa3c225ed9c313545d8748429b383ff12aa6b2a
MD5 c4b6dd0f33995edb2c626eee335ac867
BLAKE2b-256 fe94ac7660a7c2e030c1de282ded0c882724fbf104537de62fc9968b69ba963f

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