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)
- Markdown (
-
Modular & Configurable
Easily configure the tool using a simple.jsonfile 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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5f4a10377aa90db93a5e526454f4e3e616cda89519364572ccb984fba8a70494
|
|
| MD5 |
1ad2e5a34b228591e6788cf525ecbdaf
|
|
| BLAKE2b-256 |
8676690974ee3c9d7a22c5d3b39eddb81d6c72f88166b1e1a0cde178c501c3c9
|
File details
Details for the file doc_it_installer-0.1.3-py3-none-any.whl.
File metadata
- Download URL: doc_it_installer-0.1.3-py3-none-any.whl
- Upload date:
- Size: 15.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24233166e460f6f604dc461af17847415dd1d421e6e173aeef714f5314b10683
|
|
| MD5 |
21837ea78458f639d811931c71465d77
|
|
| BLAKE2b-256 |
2c144dc45e82f9a8c36973a8770d4d76d8a4dbe4e1426157bf876a770cc94841
|