Automatically generate high-quality README for your application
Project description
Dokugen Python Client 🆕
NEW! Dokugen is now available on PyPI! The Python client is fully featured and production-ready — install it just like any Python package.
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.
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
Standalone Binaries (Experimental)
[!WARNING] Experimental Vibes: These standalone binaries are super new and honestly pretty unstable. If you use them, you'll probably run into issues, that's just how it is right now. If it breaks, just stick to the Node.js and Python version for now.
You can also try our standalone binaries if you don't want to install Python or Node.js.
Windows Download dokugen-windows-x64.exe
macOS (Apple Silicon M1/M2/M3) Download dokugen-macos-arm64
macOS (Intel) Download dokugen-macos-x64
Linux Download dokugen-linux-x64
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file dokugen-3.12.2.tar.gz.
File metadata
- Download URL: dokugen-3.12.2.tar.gz
- Upload date:
- Size: 16.5 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c432e997c5bd4db16256b53f863652a1bd323f2218a25a8b19a9945b3f2f8050
|
|
| MD5 |
7ca8db531fa2f933507487d93cf16448
|
|
| BLAKE2b-256 |
9fc83a6e8a90ec2ae075c79e9b6da4a876d9119885dbffbe11db458dddc3abe8
|
