Metadata-Version: 2.1
Name: proofer
Version: 0.1.0
Summary: A CLI-based agent for proofreading and editing short-form writing
Home-page: https://github.com/joypauls/proofer
License: MIT
Keywords: cli,spellcheck,editor,agent,openai,proofreading,langgraph
Author: joypauls
Author-email: joypaulsen3@gmail.com
Requires-Python: >=3.13,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click (>=8.2.1,<9.0.0)
Requires-Dist: langgraph (>=0.5.1,<0.6.0)
Requires-Dist: openai (>=1.93.2,<2.0.0)
Requires-Dist: rich (>=14.0.0,<15.0.0)
Project-URL: Repository, https://github.com/joypauls/proofer
Description-Content-Type: text/markdown

# proofer

**⚠️ This is experimental and a work in progress.**

A minimal, CLI-based agent built with LangGraph for proofreading and editing short-form writing like blog posts. Displays a helpful git-like diff with suggestions and the option to automatically apply changes with backups.

![screenshot](./docs/images/screenshot.png)

## User Guide

### OpenAI API Key

For most tasks this library uses OpenAI API's so you'll need to set the `OPENAI_API_KEY` environment variable. An easy way to do this is to put this line:

```
export OPENAI_API_KEY=<your key>
```

in your `.zshrc` file or whichever configuration file your setup uses.

### Install

TODO

### Usage

TODO

## Development

This project currently requires Python 3.13 ([pyenv](https://realpython.com/intro-to-pyenv/) is recommended) and uses Poetry as the dependency manager and packaging tool.

For now, checkout the `Makefile` as a guide.

| Command      | Description              |
| ------------ | ------------------------ |
| make install | Install all dependencies |
| make test    | Run unit tests           |

