Installation

farscry ships as a single ~8MB binary. The npm and pip wrappers download the correct binary for your platform on first install. Models (~12MB for English) are downloaded to ~/.farscry/models/ on first run - fully offline after that.

Install

npm

npm install -g farscry

pip

pip install farscry

Homebrew

brew install teles-forge/tap/farscry

cargo

cargo install farscry

curl

curl -fsSL https://farscry.dev/install | sh

Supported platforms

Platform	Binary
macOS M1/M2/M3/M4	farscry-aarch64-apple-darwin
Linux x86_64	farscry-x86_64-unknown-linux-gnu
Windows x86_64	farscry-x86_64-pc-windows-msvc

Verify installation

farscry --version
farscry 0.1.0

First run

On first run, farscry downloads OCR models to ~/.farscry/models/ (~12MB for English: det 4.6MB + rec 7.5MB). Subsequent runs use cached models - no network call.

farscry extract screenshot.png
[first run] Downloading models to ~/.farscry/models/...
vasp_version: 1.0
...

Additional languages

English is built in. Additional languages are downloaded on demand:

npm

farscry install-lang por    # Portuguese
farscry install-lang rus    # Russian
farscry install-lang chi_sim # Chinese Simplified
farscry install-lang jpn    # Japanese

pip

farscry install-lang por    # Portuguese
farscry install-lang rus    # Russian
farscry install-lang chi_sim # Chinese Simplified
farscry install-lang jpn    # Japanese

Homebrew

farscry install-lang por    # Portuguese
farscry install-lang rus    # Russian
farscry install-lang chi_sim # Chinese Simplified
farscry install-lang jpn    # Japanese

curl

farscry install-lang por    # Portuguese
farscry install-lang rus    # Russian
farscry install-lang chi_sim # Chinese Simplified
farscry install-lang jpn    # Japanese

See Language Management for the full reference.

Smart paste (optional but recommended)

farscry setup will ask if you want to configure smart paste for your terminal.

Say yes. It takes 30 seconds. After that: Cmd+V just works with images.

farscry creates ~/.farscry/smart-paste.sh (or .ps1 on Windows) and prints the exact key binding instructions for your terminal (iTerm2, Warp, Kitty, Gnome Terminal, Windows Terminal).

Recommended: clipboard alias

After installing, add the ffix alias for zero-friction clipboard workflow:

echo "alias ffix='farscry extract --from-clipboard | claude -p \"fix this\"'" >> ~/.zshrc && source ~/.zshrc

Now: screenshot -> ffix -> Claude fixes it.

Security note

Model downloads use HTTPS with SHA256 verification. The binary never contacts any external API during image processing - it is fully offline after the initial model download.