Skip to main content

Automatically generate high-quality README for your application

Project description

Dokugen

Dokugen is a lightweight README.md file Generator Command Line Interface Tool. It simplifies the process of writing your README.md file from scratch by generating professional README.md files for your projects, saving you time and ensuring consistency using AI. The idea behind Dokugen is simple but impactful, automate the most neglected part of a repo. The results cleaner projects and happier contributors

Installation

Prerequisites

  • Python 3.8+
  • uv (Recommended) or pip

Install with uv (Recommended)

uv tool install dokugen
# or
uv pip install dokugen

Install with pip

pip install dokugen

Usage

Navigate to the project you want to work with

cd my-project

Generate a new README interactively

dokugen generate
# or
python -m dokugen generate

This command launches an interactive prompt to guide you through creating a professional README file.

Generate README with template

dokugen generate --template https://raw.githubusercontent.com/username/repo-name/blob/main/README.md

Use a custom GitHub repo readme file as a template to generate a concise and strict readme for your project.

Update Existing README (Smart Update)

dokugen update

NEW! Intelligently updates only auto-generated sections of your README while preserving all your custom content. Perfect for keeping your README fresh as your project evolves without losing your personal touch.

Check Version

dokugen --version

Features

  • Auto-Update System: Dokugen automatically checks for new versions and updates itself when you run any command. Always stay current!
  • Smart README Updates: Update your README without losing custom content. Only auto-generated sections get refreshed.
  • Automated Generation: Automatically analyzes your project and generates a comprehensive README.
  • Real-Time Streaming: Watch your README populate in real-time as it's being generated.
  • Compression Technology: Handles large codebases efficiently with 70-90% payload size reduction.
  • Easy to Use: Simple command-line interface for quick and easy README creation.
  • Cross-Platform: Works seamlessly on Windows, macOS, and Linux.
  • Programming Language and Framework Agnostic: Works with any language (e.g., Python, JavaScript, Go, C#, C, Rust, etc.)
  • Options & Flags: Supports flags and options like generating from a template, overwriting existing files, etc.

Contributing

Contributions are welcome! Read the contribution guide here.

Author

License

This project is licensed under the MIT License - see the LICENSE file for details.

Badges

License: MIT Open Source Love Maintenance PyPI Made in Nigeria

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

dokugen-14.0.0.tar.gz (39.0 kB view details)

Uploaded Source

Built Distribution

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

dokugen-14.0.0-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file dokugen-14.0.0.tar.gz.

File metadata

  • Download URL: dokugen-14.0.0.tar.gz
  • Upload date:
  • Size: 39.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.3 {"installer":{"name":"uv","version":"0.10.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for dokugen-14.0.0.tar.gz
Algorithm Hash digest
SHA256 62ca35e8c9fe62b5a8616fe71ba4ccfe2de0e75612bf4b7cd116e876e318331d
MD5 c8f280df8b78aa3e068261ec5b47bfca
BLAKE2b-256 cafda7ac509066f60693664aedfb1c33c9f757240d68f76676db9892ccec9b58

See more details on using hashes here.

File details

Details for the file dokugen-14.0.0-py3-none-any.whl.

File metadata

  • Download URL: dokugen-14.0.0-py3-none-any.whl
  • Upload date:
  • Size: 21.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.3 {"installer":{"name":"uv","version":"0.10.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for dokugen-14.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 83b5ea7b2c016d77fd314fcf29a1a213039c633ff34ba31ca8926c7e4e5e4d4c
MD5 f9ac5c077879f2e42a13e8e2fe8094e4
BLAKE2b-256 a600df66315fc72fd574015c037fcf90dac72fda3aee8bded6715a04f4c81093

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