Dokugen (Python Client)

Dokugen is a lightweight, AI-powered CLI tool that automatically generates and maintains README.md files and LICENSE files for your projects. It scans your codebase, understands what your project does, and produces clean, professional documentation, so you don't have to.

Official AI Partner & Sponsor

ApiSmart is an official sponsor and the recommended AI routing infrastructure for Dokugen.

ApiSmart provides unified access to leading AI models through a single API. Use one API key to connect with LLM, image, and video models through an OpenAI-compatible interface, without managing multiple providers separately.

Quick Start

Installation

Install Dokugen globally using uv (recommended) or pip:

uv tool install dokugen
# or
pip install dokugen

Usage

1. Launch the Interactive Assistant

Simply run dokugen in your project folder to open the interactive setup assistant. From here, you can generate a README, update existing docs, generate a LICENSE file, revert backups, or run AI-assisted Git commits.

dokugen

Note: If dokugen command is not in your PATH, you can also run it via Python:

python -m dokugen

2. Standalone Commands

Generate README

Scan your project files and construct a new README.md.

dokugen generate

Generate README with a Custom Template

Use any public README.md file as a structure template.

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

Smart Update README

Intelligently rebuilds auto-generated sections (tech stack, API details, file layout) while keeping your custom text, notes, and badges intact.

dokugen update

Generate LICENSE File

Instantly scaffold a LICENSE file for your project. Dokugen will prompt you to pick from the most common open-source licenses, pre-filled with your name and the current year.

dokugen license

Supported licenses:

• MIT, Simple and permissive. Great for most open-source projects.
• ISC, Same as MIT but shorter.
• Apache 2.0, Permissive with explicit patent rights grant.
• GNU GPLv3, Strong copyleft. Derivatives must also be open source.
• BSD 2-Clause, Permissive. Requires copyright notice preservation.
• Unlicense, Public domain. No rules, no conditions.

AI Git Commit (aic)

Analyze your staged files, generate a Conventional Commit message automatically, commit, and optionally push.

dokugen aic
# or push immediately after committing
dokugen aic --push

Safety Backup Revert (revert)

Accidentally generated something you didn't like? Restore your previous README.md instantly from the automatic backup.

dokugen revert

Generate CHANGELOG (changelog)

Analyze your Git commit history and automatically generate or update a structured CHANGELOG.md adhering to Keep a Changelog standards.

dokugen changelog
# or analyze up to a custom limit of commits
dokugen changelog --limit 100
# or specify a custom model configured on the server
dokugen changelog --model google/gemini-3.1-flash-lite

Features

• Interactive Menu: Run dokugen with no arguments to navigate all tool actions through a beautiful console prompt, perfect for both new and experienced developers.
• Smart README Updates: Re-run generation without losing your manual modifications. Only auto-generated blocks get updated; your custom content stays untouched.
• LICENSE Generator: Pick from 6 popular open-source licenses and have a properly formatted LICENSE file created instantly, pre-filled with your author name and year.
• CHANGELOG Generator: Automatically builds and prepends release notes by parsing your Git commit history since the last release tag.
• AI-Powered Commits: Automatic staging and conventional commit message generation via Google Gemini, keeps your commit history clean and consistent.
• Compressed Uploads: Efficiently packages codebases with 70–90% upload size compression to support analyzing larger projects without hitting API size limits.
• Language & Framework Agnostic: Works out of the box with any programming language or framework (JavaScript, TypeScript, Python, Rust, Go, Java, PHP, C++, Django, React, etc.). You don't need Python or Node.js to be your codebase's main language; you can simply install Dokugen globally using Python (pip/uv) or Node (npm/pnpm/yarn), and run it in any directory.
• Custom Templates: Use any public GitHub README as a structural template for your generated docs.

Contributing

Contributions are welcome! Read our Contribution Guide to get started.

License

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

Author

• Samuel Tuoyo
• X (Twitter)
• LinkedIn