Skip to main content

Automatically generate README.md using AI.

Project description

AI Readme

Generate a professional README.md automatically by analyzing project files using AI.

Features

  • English and Korean README generation.
  • Support OpenAI, Claude, Gemini models.
  • Detailed, professional README templates.
  • Smart file ignoring (.git, node_modules, etc.).
  • Easy .env based API key configuration.

Installation

pip install ai-readme

Usage

readme --lang en --provider openai
readme --lang ko --provider claude
readme --lang en --provider gemini
readme --lang en --provider openai --max_chars 20000

Setting up API Keys

You must configure your API keys before using this tool.
There are two ways:

1. Using a .env file (Recommended)

Create a .env file in your project root and add:

OPENAI_API_KEY=your-openai-api-key
CLAUDE_API_KEY=your-claude-api-key
GEMINI_API_KEY=your-gemini-api-key

The program automatically loads this file.

2. Setting environment variables manually

If you prefer, you can set them manually in your terminal session:

Linux / macOS:

export OPENAI_API_KEY=your-openai-api-key

Windows CMD:

set OPENAI_API_KEY=your-openai-api-key

Windows PowerShell:

$env:OPENAI_API_KEY="your-openai-api-key"

License

MIT License

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

ai_readme-0.1.4.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

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

ai_readme-0.1.4-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file ai_readme-0.1.4.tar.gz.

File metadata

  • Download URL: ai_readme-0.1.4.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for ai_readme-0.1.4.tar.gz
Algorithm Hash digest
SHA256 c008ee3d122fdacd8b530737e8e933295930d94c600fb88d1fee8a416a87f80e
MD5 919967a98dc1394e7d363b4f24bee809
BLAKE2b-256 b38e3ffa77571ca56bd205dc9f97e04219f695a741140d813ab046392591063a

See more details on using hashes here.

File details

Details for the file ai_readme-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: ai_readme-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.21

File hashes

Hashes for ai_readme-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 77696172eaf543cd2d322c28da4cc04d9b0a96e8878035caf05a36467646c6c6
MD5 87670176af72ee583e37e6351e77e09f
BLAKE2b-256 187fe9a378913312ee9d4de838b0b4a66a0715fea85eb27e996a1de05182dad3

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