glm-ocr-cli

GLM-OCR PDF/Image to Markdown conversion CLI.

Usage

# Convert local PDF/image file
uvx glm-ocr-cli convert path ./path/to/file.pdf

# Convert PDF/image URL
uvx glm-ocr-cli convert url https://example.com/file.pdf

# Show all commands
uvx glm-ocr-cli --help

Output Layout

Outputs are saved under ~/.glm-ocr-cli/.

~/.glm-ocr-cli/
├── history.json
└── converts/
    └── md/
        └── {sha256_16}/
            ├── main.md
            ├── result.json
            ├── original.md
            └── images/

Configuration

Config path follows the XDG Base Directory Specification:

~/.config/glm-ocr-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.