Skip to main content

Generate documentation for your repository

Project description

📄 codereviewer

AI-powered documentation generator for GitHub repositories — fetch, extract, and document any repo in seconds.

Python Gemini Groq License


✨ Features

  • 🔍 Fetches repository information directly from GitHub
  • 📂 Extracts and filters relevant source files
  • 🤖 Uses AI (Gemini + Groq) to generate human-readable documentation

🛠️ Tech Stack

Layer Technology
Language Python 3.12+
AI Providers Gemini, Groq
Core Deps gemini, git_pull, regex, scouter, doc_writer, groq

⚙️ Requirements

  • Python 3.12+
  • GEMINI_API_KEYGet it here
  • GROQ_API_KEYGet it here
  • TOKEN — Personal GitHub access token

🚀 Installation

# 1. Clone the repository
git clone https://github.com/Abbos1308/Documentation-Maker-AI.git
cd codereviewer

# 2. Create and activate a virtual environment
python -m venv myenv
source myenv/bin/activate        # Linux/Mac
# myenv\Scripts\activate         # Windows

# 3. Install the package
pip install .

# 4. Set environment variables
export GEMINI_API_KEY=your_gemini_key
export GROQ_API_KEY=your_groq_key
export TOKEN=your_github_token

⚡ Quickstart

python main.py https://github.com/owner/repo.git

Or use it programmatically:

from doc_writer import doc_maker

print(doc_maker("https://github.com/owner/repo.git"))

🔧 Configuration

All configuration is done via environment variables:

Variable Description Required
GEMINI_API_KEY Gemini API Key ✅ Yes
GROQ_API_KEY Groq API Key ✅ Yes
TOKEN Personal GitHub access token ✅ Yes

📁 Project Structure

codereviewer/
├── main.py          # Entry point — run from CLI
├── doc_writer.py    # Core documentation generation logic
└── pyproject.toml   # Project metadata & dependencies

📖 API Reference

doc_maker(link: str) -> str

Generates documentation for a given GitHub repository.

Parameters:

Name Type Description
link str Full URL of the GitHub repository

Returns: str — The generated documentation.

Example:

from doc_writer import doc_maker

docs = doc_maker("https://github.com/owner/repo.git")
print(docs)

❗ Error Reference

Error Message Cause
ERROR: Failed to fetch repository. Could be deleted or private. Please check and retry Repo is private, deleted, or the token is invalid
ERROR: Failed to connect with AI. Please try again in few minutes AI service is unreachable or rate-limited

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

docmakerai-0.1.6.tar.gz (16.8 kB view details)

Uploaded Source

Built Distribution

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

docmakerai-0.1.6-py3-none-any.whl (13.4 kB view details)

Uploaded Python 3

File details

Details for the file docmakerai-0.1.6.tar.gz.

File metadata

  • Download URL: docmakerai-0.1.6.tar.gz
  • Upload date:
  • Size: 16.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for docmakerai-0.1.6.tar.gz
Algorithm Hash digest
SHA256 59826f5f403c84e06ba7346ab32fd9e9c1ffcf15f60e82acc19e1ccaf64b92ed
MD5 fca5c4fe95cfb07b22edb0e4ec838a7a
BLAKE2b-256 5fc8810d7ae5ac1f89cd1f25f6f9aaa653901c82f8543378a68abdd887d90fe0

See more details on using hashes here.

File details

Details for the file docmakerai-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: docmakerai-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 13.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for docmakerai-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a02db74afa12c5a4ff6cc1a4e6d32aff14e7f67b9fbdaae768a1a5e3dcf68b0e
MD5 23b30da07e81591141ad78f418be629b
BLAKE2b-256 fe16dfcc8080cc683e3bb5e02babe05e283f88141d28bfb20d0361e64751abd3

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