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.5.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.5-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ai_readme-0.1.5.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.5.tar.gz
Algorithm Hash digest
SHA256 2494f2a019c163ac2d187c990fb14e37fb6761ad33e72825f73990db430d2254
MD5 00cad095678424ac62668a2b5737afe2
BLAKE2b-256 46fed75c2280d757dc771e3410a9a671d614cec78a6518249153ccfc14b717a5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ai_readme-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 8.0 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 498971eca11cd307c22450e436c24510854ab9a789d0e56f29dcf47b4654c48e
MD5 e139d3e08966ab8015cc673f382cbecd
BLAKE2b-256 92ace44f2640fe8099612e9ff844d700d51e884b8e9e9f17ba234357a9969e49

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