Skip to content

Releases

revisa 1.0.0

Choose a tag to compare

@manuelgscom manuelgscom released this 08 Nov 14:57

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 check for files and pipes (--json, --jsonl); revisa serve, a local HTTP server on 127.0.0.1 with tokens; and revisa 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 True

Then 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.AppImage

Linux, 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 model

On 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 curl or wget, 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, revision 9e753cc03f4be703f956b672b63d301fa6925af5, 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,...
Read more