Metadata-Version: 2.1
Name: easy-letters
Version: 0.1.6
Summary: A Python package for generating draft application letters using generative AI
Home-page: https://github.com/habedi/easy-letters
License: MIT
Author: Hassan Abedi
Author-email: hassan.abedi.t@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Provides-Extra: dev
Provides-Extra: test
Requires-Dist: black (>=24.4.2,<25.0.0) ; extra == "test" or extra == "dev"
Requires-Dist: jupyter (>=1.0.0,<2.0.0) ; extra == "dev"
Requires-Dist: openai (>=1.16.1,<2.0.0)
Requires-Dist: pandas (>=2.2.2,<3.0.0) ; extra == "test" or extra == "dev"
Requires-Dist: poetry-dynamic-versioning (>=1.4.0,<2.0.0) ; extra == "dev"
Requires-Dist: pytest (>=8.2.2,<9.0.0) ; extra == "test" or extra == "dev"
Requires-Dist: pytest-cov (>=5.0.0,<6.0.0) ; extra == "test" or extra == "dev"
Requires-Dist: qdrant-client (>=1.8.2,<2.0.0)
Requires-Dist: tiktoken (>=0.7.0,<0.8.0) ; extra == "dev"
Project-URL: Repository, https://github.com/habedi/easy-letters
Description-Content-Type: text/markdown

# Easy Letters

[![Tests](https://github.com/habedi/easy-letters/actions/workflows/tests.yml/badge.svg)](https://github.com/habedi/easy-letters/actions/workflows/tests.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/easy-letters.svg)](https://badge.fury.io/py/easy-letters)
[![Downloads](https://pepy.tech/badge/easy-letters)](https://pepy.tech/project/easy-letters)

Easy Letters is a Python package to help job seekers writing application letters. It uses a simple retrieval
augmented generation (RAG) pipeline to generate the letters. The user can then edit the draft letter to suit their
needs.

## Installation

You can install Easy Letters using pip:

```bash
pip install easy-letters
```

## Getting Started

### API Key Setup

At the moment, Easy Letters gets the API key for supported services from the environment variables.
So you need to set the following environment variables to be able to use Easy Letters:

- `OPENAI_API_KEY`: The OpenAI API key (required)

### Sample Notebooks

You can find Jupyter notebooks with example code in the `notebooks` directory.
The notebooks demonstrate how to use Easy Letters to generate application letter drafts.

### Supported Models

Easy Letters currently supports the following models:

| Model                            | Type            |
|----------------------------------|-----------------|
| GPT-3.5 Turbo                    | Text Generation |
| GPT-4o                           | Text Generation |
| Text Embedding 3 (Small Variant) | Text Embedding  |
| Text Embedding 3 (Large Variant) | Text Embedding  |

## TODO

- [ ] Add support for Anthropic models and API
- [ ] Add support for locally served models via Ollama

