Skip to main content

Code2Docs: An AI-powered, open source CLI tool for generating inline code documentation, API references, database schema docs, and project READMEs from your codebase.

Project description

🚀 Code2Docs CLI

Code2Docs is an AI-powered CLI tool that helps you generate high-quality documentation for your codebase — including inline docstrings, API documentation, database schema descriptions, and project READMEs.

⚠️ This project is still under active development. Expect new features and improvements regularly.

📚 Base Repo: https://github.com/xKarinSan/Code2Docs
💬 Community Discord: https://discord.gg/qugCeYBYud 🌐 Landing Page: https://code2docs-open-source.netlify.app/
🔗 LinkedIn: https://www.linkedin.com/company/code2docs

✨ Features

  • 📄 Inline documentation (docstrings + inline comments)
  • 📡 API endpoint documentation (coming soon)
  • 🧩 Database schema documentation (coming soon)
  • 📘 README.md generation (coming soon)
  • 🗂️ Architecture diagram generation (coming soon)

🔐 Requirements

  • Python 3.8 or newer
  • An OpenAI API key
  • A Git-initialized codebase

🧪 Installation

  1. Install the CLI:

    pip install c2d
    
  2. Run the CLI:

    code2docs-cli
    

🚀 Getting Started

To begin using Code2Docs:

  1. Make sure your project is inside a Git repository.
  2. Get your OpenAI API key from platform.openai.com.
  3. Save your API key locally using:
c2d save-key sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  1. You’re ready to generate documentation!

🛠️ CLI Commands

--help

Lists ALL the commands for Code2Docs CLI

code-doc

Generates inline documentation (docstrings and comments) for your codebase.

c2d code-doc

api-doc (Coming Soon)

Generates documentation for your API endpoints.

c2d api-doc

db-doc (Coming Soon)

Generates documentation for your database schema.

c2d db-doc

readme-doc (Coming Soon)

Generates a project-level README.md based on your codebase.

c2d readme-doc

archi-doc (Coming Soon)

Generates an architecture diagram based on the structure of your codebase.

c2d archi-doc

archi-doc (Coming Soon)

Generates an architecture diagram based on the structure of your codebase.

c2d archi-doc

save-key

Saves your OpenAI API key locally for authentication.

c2d save-key sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

load-key

Displays the currently saved OpenAI API key.

c2d load-key

--help

Displays all available commands and usage.

c2d --help

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

code2docs_cli-1.0.1.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

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

code2docs_cli-1.0.1-py3-none-any.whl (8.7 kB view details)

Uploaded Python 3

File details

Details for the file code2docs_cli-1.0.1.tar.gz.

File metadata

  • Download URL: code2docs_cli-1.0.1.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.9 Darwin/21.6.0

File hashes

Hashes for code2docs_cli-1.0.1.tar.gz
Algorithm Hash digest
SHA256 5ba8f6b37dc725ceb563345b82f7db48c442dcae4dfdcfc5fc80d7141795dce7
MD5 1cd6698aa9aa6bbbe43640d95bd7d092
BLAKE2b-256 69c19f527ea55a781b318d2875590d7e6215b4ebf0c775c47db6b995277bf93f

See more details on using hashes here.

File details

Details for the file code2docs_cli-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: code2docs_cli-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 8.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.2 CPython/3.12.9 Darwin/21.6.0

File hashes

Hashes for code2docs_cli-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ee2e17c68a7061fbed1a9362fcc3830d8a831cfd4e9e7cf95149fac2336e2f16
MD5 d703b38d768a76dce8bb99f8f72d232a
BLAKE2b-256 7ccdb6f38def26029ed62e84af19be74e7c82ef5bf616c389ad1514c5bcfd6b3

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