# Project pack: LanguageTool @ 535904c

Facts about **LanguageTool** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> LanguageTool finds spelling, grammar and style mistakes in more than 30 languages. It runs as a small server that browser extensions, LibreOffice and other tools can talk to, so your writing can be checked without being sent to a third-party company. You can add your own rules in simple XML files.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Download the prebuilt program for your system and run it. No Docker. Needs Java installed.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/languagetool-org/languagetool/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/languagetool-org/languagetool
- Pinned commit: `535904c66ac73708eb6f21c69468459c622a33a5`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/languagetool-org/languagetool/archive/535904c66ac73708eb6f21c69468459c622a33a5.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://dev.languagetool.org
- Licence: **LGPL-2.1-only**. Free to use and change. If you share a changed version of the library itself, you must share those changes under the same licence. Using it privately has no extra obligations.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/languagetool-org/languagetool bespoke-languagetool
  cd bespoke-languagetool
  git checkout --detach 535904c66ac73708eb6f21c69468459c622a33a5
  # Prepare development requirements and local configuration first.
  ./build.sh languagetool-standalone package -DskipTests
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name languagetool -p 8010:8010 erikvl87/languagetool
  # then open http://localhost:8010/v2/check?language=en-US&text=This%20are%20wrong
  ```
- Tools these commands use: Docker for a trial, JDK 17+ and Maven for development
- Develop: `./build.sh languagetool-standalone package -DskipTests`
- Test: `mvn test -pl languagetool-core`
- Stack: java, xml (Maven, Java HTTP server). Difficulty for a non-developer with an AI: **moderate**. A large Java project, but the common customisation (new grammar rules and a personal dictionary) is plain XML and text files. Changing the engine requires Java and Maven.
Personal data: **no**. Stored in: Rules and dictionaries are files. The server keeps no text after checking it. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/languagetool/535904c/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/languagetool/535904c/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/languagetool/535904c/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/languagetool/535904c/r3/SKILL.md)