Metadata-Version: 2.4
Name: pdfask
Version: 0.1.0
Summary: Chat with a PDF on the command line, powered by Claude.
Project-URL: Homepage, https://github.com/dsl16/pdf-chat
Project-URL: Repository, https://github.com/dsl16/pdf-chat
Project-URL: Issues, https://github.com/dsl16/pdf-chat/issues
Author-email: Darrin Lim <7447840+dsl16@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Keywords: anthropic,chat,claude,cli,pdf
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: anthropic>=0.100.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# pdfask

Chat with a PDF on the command line, powered by Claude.

Uses Claude's native PDF support — no text extraction, no OCR. The model
reads the document directly, including tables, layout, and embedded images.
Prompt caching makes follow-up questions ~10x cheaper than the first.

## Install

```bash
pip install pdfask
```

Or with [uv](https://github.com/astral-sh/uv):

```bash
uv tool install pdfask
```

## Setup

Get an API key from <https://console.anthropic.com/settings/keys>, then either
export it:

```bash
export ANTHROPIC_API_KEY=sk-ant-...
```

…or drop it in a `.env` file in whatever directory you're running `pdfask` from:

```
ANTHROPIC_API_KEY=sk-ant-...
```

## Usage

One-shot question:

```bash
pdfask report.pdf "What's the executive summary?"
```

Interactive REPL (Ctrl-D to exit):

```bash
pdfask report.pdf
```

## Configuration

| Env var             | Default            | Notes                           |
| ------------------- | ------------------ | ------------------------------- |
| `ANTHROPIC_API_KEY` | *(required)*       | From console.anthropic.com      |
| `ANTHROPIC_MODEL`   | `claude-opus-4-7`  | Override to use a smaller model |

## Development

```bash
git clone https://github.com/dsl16/pdf-chat
cd pdf-chat
uv tool install --editable .
```

## License

MIT
