yapit
CLI for yapit.md — fetch clean markdown from URLs, files, and documents.
Install
uv tool install yapit
Usage
# 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 account:
export YAPIT_EMAIL=you@example.com
export YAPIT_PASSWORD=...
Fetching shared documents works without auth.
Self-hosting
Point the CLI at your own instance with YAPIT_BASE_URL:
export YAPIT_BASE_URL=http://localhost:8000
yapit fetch paper.pdf
If your server runs with AUTH_ENABLED=false (the make self-host default), no credentials are needed. If auth is enabled on your instance, set YAPIT_EMAIL / YAPIT_PASSWORD as above.
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.
1 maintainer
Release files for yapit 0.3.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yapit-0.3.10.tar.gz | 9.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yapit-0.3.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.0 kB
Release files / yapit-0.3.10.tar.gz
| Download URL | yapit-0.3.10.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be4e597e21c9abf7d7fa440f990c430605fbae917dc1be81e2386e30a5e4b158
|
|
BLAKE2b-256 checksum How to use checksums |
406182a7023c02b96ad5a744c01be14b9a4e2704b001b08184daf8d3c1027f20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / yapit-0.3.10-py3-none-any.whl
| Download URL | yapit-0.3.10-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
de9f8734d2e7072895086999be64cf61f76c323d4b063de3b349f19e6b62edf4
|
|
BLAKE2b-256 checksum How to use checksums |
e830b5bbbfbf8ebf37fc206a69a7e8a74379a2b143e8e962ea79bc074d3e08de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
