mathpix-cli

Mathpix CLI for PDF conversion and image snips.

Usage

# Convert a local PDF
uvx mathpix-cli convert pdf path ./path/to/file.pdf

# Convert a PDF from a URL
uvx mathpix-cli convert pdf url https://example.com/file.pdf

# Snip an image
uvx mathpix-cli snip image ./path/to/equation.png

# Show all commands
uvx mathpix-cli --help

Output Layout

Outputs are saved under ~/.mathpix-cli/.

~/.mathpix-cli/
├── history.json
├── converts/
│   └── {format}/
│       └── {sha256_16}/
│           ├── main.{ext}
│           ├── original.{ext}
│           └── images/
└── snips/
    └── {format}/
        └── {sha256_16}/
            ├── main.{ext}
            └── {fingerprint}/
                └── main.{ext}

Configuration

Config path follows the XDG Base Directory Specification:

~/.config/mathpix-cli/config.toml

See config.example.toml for all available options.

Development

just setup-dev

Tooling

• Runtime: uv
• JS/TS: Biome
• Python: Ruff, mypy, pytest, Poe
• Project template: Copier
• Task runner: just
• Git hooks: Lefthook

Dependencies

Automated via Renovate. Dependency update PRs are created automatically.

Release

Automated via release-please. Merge the auto-generated Release PR to bump version, update CHANGELOG.md, and create a tag.