Skip to main content

Auto-generate README files from folder structure

Project description

projectreadmegen

Auto-generate README files from folder structure, with optional AI enhancement using Groq API.

Installation

pip install projectreadmegen

Usage

Basic (Template-based)

projectreadmegen generate .

With AI Enhancement (Groq)

# Set API key
export GROQ_API_KEY=your_key_here

# Generate AI-powered README
projectreadmegen generate . --ai

Options

  • --template, -t: Template to use (minimal, standard, full, academic)
  • --output, -o: Output filename (default: README.md)
  • --depth, -d: Max folder tree depth (default: 3)
  • --ai, --grok: Use Groq AI to generate enhanced README
  • --auto-ai: Auto-detect and use AI when API key is available

Configuration

Create readmegen.config.json in your project root:

{
    "template": "standard",
    "ai_enabled": true,
    "groq_api_key": "your_key_here"
}

Features

  • Auto-detect project type and tech stack
  • Generate folder tree visualization
  • AI-powered README generation with Groq
  • Multiple template options (minimal, standard, full, academic)
  • Badge generation for language and license

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

projectreadmegen-1.1.0.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

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

projectreadmegen-1.1.0-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

Details for the file projectreadmegen-1.1.0.tar.gz.

File metadata

  • Download URL: projectreadmegen-1.1.0.tar.gz
  • Upload date:
  • Size: 20.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for projectreadmegen-1.1.0.tar.gz
Algorithm Hash digest
SHA256 03f924402c071e28b3edec8a64dcd425e6a6ba8f6d198361cfa26529096c9688
MD5 6fe436be0079bb83b4324765f22da73d
BLAKE2b-256 5d8fa52a032a2d729141850233b87a7eb8f60496521fec5d1ee6c6a37800bc1b

See more details on using hashes here.

File details

Details for the file projectreadmegen-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for projectreadmegen-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cc13e5e3b298a4ec6cdd613e07128b0995933360de79b1f8fc2dc584a3667e67
MD5 0dbbfc7c9c83e2b5a4826bd013cd3517
BLAKE2b-256 d2a96f4cef36d624850d7329235afbfb9d1388fdc0646d178d5e3d9da73a36b2

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