<commit_before>## About

```callout{'title': 'Heads up!', 'classes': ['success']}
**Tired of the command line?** Vale now has a [cross-platform desktop application](https://errata.ai/vale-server/) that introduces a number of new features.
```

![Vale Screenshot](img/vale-demo.png)

**Vale** is a cross-platform (macOS, Windows, and Linux), command-line linter for prose built with speed and extensibility in mind.

Unlike most writing-related software, Vale's primary purpose isn't to provide its own advice; it's designed to
enforce an existing style guide through its YAML-based [extension system](/vale/styles).

No matter if you're working with a small in-house standard or a large editorial style guide, Vale
will help you maintain consistent and error-free writing.

## Installation

Vale offers multiple options for installation, each of which best suits a particular use case.

### Remote, collaborative use

One of Vale's strengths is its ability to help a company, project, or organization maintain consistency (capitalization styles, word choice, brand terminology, etc.) across multiple writers.

The benefits of the following installation methods are that every writer has access to the same Vale configuration without having to install and configure the tools themselves.

#### Using Vale with GitHub

If you want to lint the contents of a GitHub repository, the recommended approach is to use Vale's [official GitHub Action](https://github.com/errata-ai/vale-action).

#### Using Vale with a continuous integration (CI) service

If you want to use Vale with a CI service such as Travis CI, CircleCI, or Jenkins, the recommended approach is to use Vale's
[GoDownloader](https://github.com/goreleaser/godownloader) script:

```console
# Vale will be installed to `/bin/vale`.
$ curl -sfL https://install.goreleaser.com/github.com/ValeLint/vale.sh | sh -s vX.Y.Z
$ export PATH="./bin:$PATH"
$ vale -v
```
where `vX.Y.Z` is your version of choice from the [releases page](https://github.com/errata-ai/vale/releases).

### Local use by a single writer

Vale can also be used locally by a single writer through their command line or a third-party integration.

#### Using Vale with a text editor (or another third-party application)

Vale has a commercial desktop application, [Vale Server](https://errata.ai/vale-server/), that integrates with [many third-party applications](https://errata-ai.github.io/vale-server/docs/usage#step-5-using-a-client-application) (including Atom, Sublime Text, VS Code, and Google Docs) and allows writers to easily create and switch between multiple local Vale configurations.

It also [offers seamless integration](https://errata-ai.github.io/vale-server/docs/style#third-party-styles) with [LanguageTool](https://www.languagetool.org/), providing access to over 2,000 English grammar rules.

#### Using Vale from the command line

Vale can be installed for local usage by downloading an executable from the [releases page](https://github.com/errata-ai/vale/releases) or by pulling the [latest Docker container](https://cloud.docker.com/repository/docker/jdkato/vale).
<commit_msg>Add: link to Formats section from install cli (#158)<commit_after>## About

```callout{'title': 'Heads up!', 'classes': ['success']}
**Tired of the command line?** Vale now has a [cross-platform desktop application](https://errata.ai/vale-server/) that introduces a number of new features.
```

![Vale Screenshot](img/vale-demo.png)

**Vale** is a cross-platform (macOS, Windows, and Linux), command-line linter for prose built with speed and extensibility in mind.

Unlike most writing-related software, Vale's primary purpose isn't to provide its own advice; it's designed to
enforce an existing style guide through its YAML-based [extension system](/vale/styles).

No matter if you're working with a small in-house standard or a large editorial style guide, Vale
will help you maintain consistent and error-free writing.

## Installation

Vale offers multiple options for installation, each of which best suits a particular use case.

### Remote, collaborative use

One of Vale's strengths is its ability to help a company, project, or organization maintain consistency (capitalization styles, word choice, brand terminology, etc.) across multiple writers.

The benefits of the following installation methods are that every writer has access to the same Vale configuration without having to install and configure the tools themselves.

#### Using Vale with GitHub

If you want to lint the contents of a GitHub repository, the recommended approach is to use Vale's [official GitHub Action](https://github.com/errata-ai/vale-action).

#### Using Vale with a continuous integration (CI) service

If you want to use Vale with a CI service such as Travis CI, CircleCI, or Jenkins, the recommended approach is to use Vale's
[GoDownloader](https://github.com/goreleaser/godownloader) script:

```console
# Vale will be installed to `/bin/vale`.
$ curl -sfL https://install.goreleaser.com/github.com/ValeLint/vale.sh | sh -s vX.Y.Z
$ export PATH="./bin:$PATH"
$ vale -v
```
where `vX.Y.Z` is your version of choice from the [releases page](https://github.com/errata-ai/vale/releases).

### Local use by a single writer

Vale can also be used locally by a single writer through their command line or a third-party integration.

#### Using Vale with a text editor (or another third-party application)

Vale has a commercial desktop application, [Vale Server](https://errata.ai/vale-server/), that integrates with [many third-party applications](https://errata-ai.github.io/vale-server/docs/usage#step-5-using-a-client-application) (including Atom, Sublime Text, VS Code, and Google Docs) and allows writers to easily create and switch between multiple local Vale configurations.

It also [offers seamless integration](https://errata-ai.github.io/vale-server/docs/style#third-party-styles) with [LanguageTool](https://www.languagetool.org/), providing access to over 2,000 English grammar rules.

#### Using Vale from the command line

Vale can be installed for local usage. To install the CLI, use one of the following options:

- Download an executable from the [releases page](https://github.com/errata-ai/vale/releases)
- Pulling the [latest Docker container](https://cloud.docker.com/repository/docker/jdkato/vale)
- On macOS: run `brew install vale`

**Note:** Depending on the type of file that you lint, you might need to install [extra tools](https://errata-ai.github.io/vale/formats/#formats).

{'fraction_non_alphanumeric': 0.10012266176019625, 'fraction_numerical': 0.0019932536031892056, 'mean_word_length': 4.824107142857143, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 23, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2058556', 'n_tokens_mistral': 1879, 'n_tokens_neox': 1752, 'n_words': 778}