Install Binary¶
Install r10n as a standalone binary using curl, then run it directly from your terminal.
Prerequisites¶
- macOS or Linux
curl
Install with curl¶
Quick install:
Safer two-step install:
curl -fsSL https://raw.githubusercontent.com/pruthivithejan/r10n/main/install.sh -o install.sh
sh install.sh
The installer downloads the correct app archive for your OS/architecture, verifies checksums, installs the extracted app under ~/.local/bin/.r10n, and creates the ~/.local/bin/r10n launcher.
The release workflow publishes the binaries and SHA256SUMS automatically after a version bump on main, so install.sh always targets the latest published release.
Verify¶
Run the terminal UI:
The home screen shows the ASCII banner, available automations, and a command input box. Type commands such as contacts, images --input ./photos, or upgrade --check; the session stays open until you press Ctrl+C.
If r10n is not found, add this to your shell profile:
Then restart the terminal.
Upgrade¶
Update to the latest release:
Check only (no install):
Install a specific version:
Optional installer flags¶
Install a specific version:
Install to a custom directory:
Troubleshooting¶
Permission denied during upgrade¶
Install to a writable path such as ~/.local/bin, then retry:
TLS certificate verification failed during upgrade¶
r10n upgrade uses the packaged certifi CA store for GitHub downloads. If your network uses a custom proxy certificate, set SSL_CERT_FILE to that CA bundle and retry.
If your installed binary is older and fails before it can use the fixed upgrader, reinstall once with the installer instead of r10n upgrade:
Then verify:
Unsupported platform¶
Current prebuilt binaries support:
- Linux x86_64
- macOS arm64
- Windows x86_64 (release artifact only)
Use Run on Terminal with uvx if your platform is not yet available.
Next Steps¶
- Run on Terminal — Use r10n without installing
- Setup Locally — Full local source setup
- Automations — Explore all commands