Skip to main content

A modular CLI tool to automatically generate documentation for code changes using a local Ollama LLM.

Project description

Doc-It

Doc-It is a powerful, modular command-line tool that leverages local Large Language Models (LLMs) via Ollama to automatically generate professional documentation for your code changes.
Track your work, explain complex changes in natural language, and export your documentation to multiple formats — all from your terminal.


Features

  • AI-Powered Explanations
    Automatically generates clear, human-readable explanations for code modifications.

  • Fully Local
    Uses your local Ollama instance — ensuring your code stays private and secure.

  • Snapshot-Based Tracking
    Intelligently detects changes by comparing snapshots of your codebase.
    No Git dependency required.

  • Multiple Export Formats
    Generate documentation in:

    • Markdown (.md)
    • Microsoft Word (.docx)
    • LaTeX (.tex)
  • Modular & Configurable
    Easily configure the tool using a simple .json file to:

    • Specify the Ollama model
    • Select files to watch
    • Customize behavior
  • Simple CLI Interface
    Clean and intuitive commands for a seamless documentation experience.


Prerequisites

Ensure you have the following installed on your system:

  • Python 3.10 or higher
  • Ollama
  • At least one Ollama model pulled (e.g. Llama 3):
ollama pull llama3

Installation

Install Doc-It from PyPI:

pip install doc-it-installer

Usage

Navigate to your project’s root directory and follow this three-step workflow:

1️⃣ Initialize Your Project

Sets up the .docit directory, initializes a snapshot database, scans your codebase, and creates a high-level summary using AI.

doc-it init

Run this only once per project.


2️⃣ Analyze and "Commit" Changes

After modifying your code, use the commit command.
Doc-It compares snapshots and sends the differences to AI for explanation.

doc-it commit -m "Refactored the user authentication module"

💡 The -m flag is required to describe your update.


3️⃣ Generate the Documentation

Create a final documentation file using the generate command.

Default (Markdown):

doc-it generate

Generate a Word document:

doc-it generate --format docx

Generate a LaTeX document:

doc-it generate --format tex

Authors

  • Kartik Sharma
  • Harshvardhan Singh

License

This project is licensed under the MIT License.


Empower your code with intelligent documentation. Let Doc-It do the writing.

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

doc_it_installer-0.1.3.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

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

doc_it_installer-0.1.3-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file doc_it_installer-0.1.3.tar.gz.

File metadata

  • Download URL: doc_it_installer-0.1.3.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.6

File hashes

Hashes for doc_it_installer-0.1.3.tar.gz
Algorithm Hash digest
SHA256 5f4a10377aa90db93a5e526454f4e3e616cda89519364572ccb984fba8a70494
MD5 1ad2e5a34b228591e6788cf525ecbdaf
BLAKE2b-256 8676690974ee3c9d7a22c5d3b39eddb81d6c72f88166b1e1a0cde178c501c3c9

See more details on using hashes here.

File details

Details for the file doc_it_installer-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for doc_it_installer-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 24233166e460f6f604dc461af17847415dd1d421e6e173aeef714f5314b10683
MD5 21837ea78458f639d811931c71465d77
BLAKE2b-256 2c144dc45e82f9a8c36973a8770d4d76d8a4dbe4e1426157bf876a770cc94841

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