Metadata-Version: 2.4
Name: yapit
Version: 0.3.3
Summary: CLI for yapit.md — fetch clean markdown from URLs and documents
Keywords: cli,tts,markdown,document-extraction,yapit
Author: Maximilian Wolf
Author-email: Maximilian Wolf <max@mwolf.dev>
License-Expression: AGPL-3.0-only
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Markup :: Markdown
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Dist: tyro>=1.0.9
Requires-Dist: httpx>=0.28.1
Requires-Python: >=3.14
Project-URL: Repository, https://github.com/yapit-tts/yapit-cli
Project-URL: Issues, https://github.com/yapit-tts/yapit-cli/issues
Project-URL: Homepage, https://yapit.md
Description-Content-Type: text/markdown

# yapit

CLI for [yapit.md](https://yapit.md) — fetch clean markdown from URLs, files, and documents.

## Install

```bash
uv tool install yapit
```

## Usage

```bash
# Create document from URL, print markdown
yapit https://example.com/article
yapit https://arxiv.org/abs/2301.00001

# Local files
yapit paper.pdf
yapit notes.md

# With AI transformation (TTS annotations, spoken readings for math, figure extraction, noise filtering)
yapit paper.pdf --ai

# Fetch existing document
yapit https://yapit.md/listen/<doc-id>
yapit <doc-id> --annotated

# Save to directory with images
yapit <doc-id> -o .

# Stdin
echo "hello world" | yapit -
```

## Auth

Creating documents or accessing private docs requires a [yapit.md](https://yapit.md) account:

```bash
export YAPIT_EMAIL=you@example.com
export YAPIT_PASSWORD=...
```

Fetching shared documents works without auth.

## Save to directory (`-o`)

`-o <dir>` saves markdown, TTS annotations, and images:

```
<dir>/<slug>/
  <slug>.md       # clean markdown, image paths rewritten to relative
  TTS.md          # annotated version (yap-speak, yap-show tags)
  <slug>-<N>.png  # images renamed sequentially
```

Errors if the output directory already exists.
