Repository navigation
Releases
revisa 1.0.0
revisa 1.0.0
A Spanish proofreader that works in any app. Runs on your CPU, 100% offline.
Select some Spanish text in any application (an email in the browser, a chat, a document, a terminal) and press Ctrl+Alt+Space. A small window shows each correction with a one-line explanation; Enter puts the corrected text in place of your selection and Esc leaves it as it was. A small model fine-tuned for this one task, revisa-0.8b, runs on your CPU inside a native C++ engine with llama.cpp; deterministic code decides which changes you see and explains each one. No account, no telemetry, no GPU: the only connection revisa makes is the one-time download of its model.
The first public release, for Windows 10/11 (x64) and Linux (x86_64). The interface is in Spanish.
Highlights
-
Works in any app, with one global shortcut: no plugins or integrations. It reads the selection, shows the changes and pastes the result back into the window you were in, terminals included. Uncheck any change before applying.
-
Every change explained. A closed catalog of 31 error types: spelling, accents, homophones (haber / a ver, porque / por qué, echo / hecho), dequeísmo, leísmo, impersonal haber, agreement, typos and more. Each edit gets a fixed explanation in Spanish; the model never makes up grammar.
-
When in doubt, it doesn't touch. Deterministic guards drop doubtful edits or whole sentences, and URLs, email addresses, @mentions, code, paths and numbers are protected. It corrects the norm, never your style.
-
Fast on a CPU. Speculative decoding guided by your own sentence: 138 ms per sentence at the median on a desktop CPU with 8 threads, 2.2× faster than plain decoding, and identical output on 99.4% of sentences.
-
Measured on a new public benchmark (
revisa-bench-es, 2,388 cases): real errors by native speakers (parts A and B) plus a synthetic part in the register revisa is made for (C). F0.5 and false alarms on already-correct sentences:System A · Wikipedia edits B · Talk pages C · Emails and chat revisa-0.8b 81.5 · 1.8% 80.0 · 2.4% 92.0 · 0.9% Qwen3.5-9B, untuned 79.8 · 4.3% 69.6 · 3.8% 91.2 · 0.6% LanguageTool 6.6 24.1 · 39.0% 52.8 · 25.1% 74.1 · 11.1% -
For your tools too:
revisa checkfor files and pipes (--json,--jsonl);revisa serve, a local HTTP server on127.0.0.1with tokens; andrevisa lsp, a language server for Markdown, plain text and commit messages (configurations for Neovim and Helix in the README).
Downloads
| Asset | What it is | Platform | SHA-256 |
|---|---|---|---|
revisa-setup.exe |
Installer for your user only (no administrator rights): the tray app revisa-tray.exe, the CLI revisa.exe, Qt 6.8.3 and the MSVC runtime |
Windows 10 (1903 or later) or 11, x64 | 9cc9c1313dd25972563afd7d40dd8d821149a91d74f019c10a97561369a39857 |
revisa-x86_64.AppImage |
The tray app and the CLI in one file, with Qt 6.8.3 | Linux x86_64, glibc 2.31 or later | 30a5ac1c3a635e153e5dd6e75225c9ffeadc2d8137697e493762c1987c729dc3 |
revisa-linux-x86_64.tar.gz |
The CLI alone (static C++ runtime, depends only on glibc), with LICENSE, THIRD_PARTY_NOTICES and README.txt |
Linux x86_64, glibc 2.31 or later | 8bb7d851bd148fae08ad3741263f532c71cc819a6c4b23961154dec725588aac |
SHA256SUMS |
Checksums of the three packages (the model's is under The model) | — | — |
revisa-demo-windows.mp4 |
Demo on Windows 11: a webmail, a team chat and Notepad | — | — |
revisa-demo-linux.mp4 |
Demo on Linux (X11): a webmail and a chat in Firefox, and Mousepad | — | — |
demo-windows-mail.mp4, demo-windows-chat.mp4, demo-windows-notepad.mp4 |
The Windows demo, one scene per file | — | — |
The demos are recordings of the real app and model, with scripted input.
Install
Windows. Download revisa-setup.exe and SHA256SUMS. To verify the installer, run this in PowerShell:
cd $HOME\Downloads
(Get-FileHash .\revisa-setup.exe -Algorithm SHA256).Hash.ToLower() -eq ((Select-String -Path .\SHA256SUMS -Pattern 'revisa-setup.exe').Line -split '\s+')[0] # must print TrueThen run it. The installer is not code-signed, so SmartScreen shows Windows protected your PC: click More info, then Run anyway. It installs into %LOCALAPPDATA%\Programs\revisa and offers to start revisa with Windows (checked), to add revisa to the PATH and to create a desktop shortcut (both unchecked).
Linux, the tray app:
mkdir -p ~/Applications && cd ~/Applications
curl -LO https://github.com/manuelgscom/revisa/releases/download/v1.0.0/revisa-x86_64.AppImage
curl -LO https://github.com/manuelgscom/revisa/releases/download/v1.0.0/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS # must print: revisa-x86_64.AppImage: OK
chmod +x revisa-x86_64.AppImage
./revisa-x86_64.AppImageLinux, terminal only:
curl -LO https://github.com/manuelgscom/revisa/releases/download/v1.0.0/revisa-linux-x86_64.tar.gz
curl -LO https://github.com/manuelgscom/revisa/releases/download/v1.0.0/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS # must print: revisa-linux-x86_64.tar.gz: OK
tar xzf revisa-linux-x86_64.tar.gz
install -Dm755 revisa-*-linux-x86_64/revisa ~/.local/bin/revisa
export PATH="$HOME/.local/bin:$PATH" # or log out and back in
revisa --version
echo "Ya e echo el informe." > prueba.txt
revisa check prueba.txt # the first run asks to download the modelOn the first start, the tray app (or the first revisa check in a terminal) asks to download the model (on Linux, this needs curl or wget), checks its SHA-256 and keeps it in %LOCALAPPDATA%\revisa\models on Windows or ~/.local/share/revisa/models/ on Linux. After that, revisa works offline. The README has step-by-step instructions, the clipboard mode for Wayland, the configuration file, the editor setup and how to build from source.
Requirements
- An x86-64 CPU with AVX2 (with FMA and F16C). Without it, revisa refuses to start with a clear message instead of crashing.
- About 2 GB of free RAM and 529 MB of disk for the model.
- Windows: Windows 10 version 1903 or later, or Windows 11, 64-bit. Tested on Windows 11.
- Linux: glibc 2.31 or later. Tested on Ubuntu 22.04 and 24.04, Debian 12, Fedora 45 and Linux Mint 22.2. The full shortcut flow needs an X11 session; under Wayland, revisa works in clipboard mode. The model download needs
curlorwget, which nearly every desktop has.
The model
revisa-0.8b is a full fine-tune of Qwen3.5-0.8B for Spanish proofreading, quantized to Q4_K_M with an importance matrix. It receives one sentence and returns it corrected, in plain text. The download URL is pinned to a fixed revision and compiled into the binaries, with the size and SHA-256 of the file:
revisa-0.8b-Q4_K_M.gguf, revision9e753cc03f4be703f956b672b63d301fa6925af5, 529 MB (529,297,888 bytes):7ee833111c7574aa5b37eed9b292ab21c539b203d687250f8e8deee0cba9127b
To use a local copy instead, pass --model PATH to the CLI or set model = PATH in the configuration file. The model card describes the training, the evaluation and how to run it with llama.cpp directly.
Known limitations
- Spanish only, and the interface is in Spanish.
- Each sentence is corrected on its own, without the surrounding text.
- It corrects the norm, not style: no rephrasing and no commas of taste. It is built to stay quiet when unsure, so it may miss errors, and the model can be wrong: read the changes before pressing Enter.
- Windows: the shortcut does not reach windows running as administrator (Windows does not let a normal app send them keys). The installer is not code-signed.
- Linux: under Wayland there is no global shortcut or automatic paste; copy the text, check it from the tray menu or a desktop shortcut, and paste the result. The shortcut must run the AppImage by its full path, since shortcuts do not expand
~(for example/home/you/Applications/revisa-x86_64.AppImage --check-clipboard). - x86-64 with AVX2 only; no macOS and no ARM builds.
- No automatic updates: new versions are published here.
License
- Code: MIT, except
src/core/catalog/dictionary.cpp, which keeps Hunspell's MPL 1.1 / GPL 2.0 / LGPL 2.1 tri-license. - Model: Apache-2.0, like its base model. Benchmark: CC BY-SA 4.0.
- The packages include llama.cpp/ggml, cpp-httplib,...