Eric Putnam

Project 02
Python
Live demo

FedStyleValidator

Checks Word documents against federal writing, formatting, accessibility, and terminology rules — before they reach review.

Independent project. Not an official product of, affiliated with, endorsed by, or sponsored by the U.S. Government, the FAA, or any agency.

§ 01
In the browser

What it looks like

FedStyleValidator upload panel, ready to validate a Word document, with document type and category filters.
Upload a DOCX and choose a document type.
FedStyleValidator validation findings grouped by category, showing error and warning counts after a check.
Findings grouped by category, after a validation run.

§ 02
Overview

What it does

Use FSV to scan Advisory Circulars, Orders, and other federal documents before review or publication. It reports issues by category and severity, includes document metadata, and can produce machine-readable output for automation.

The point is to move style enforcement out of the reviewer’s head and into something repeatable. A style guide that lives only in a PDF gets applied inconsistently; encoded as rule packs with severities, it can run on every draft, every time — or in a build pipeline.

§ 03
Capabilities

What ships with it

  • Command-line tool

    For local and batch document checks across a directory of drafts.

  • Built-in rule packs

    Federal, FAA, DOT OGC, plain language, accessibility, and external prose checks.

  • Backend and UI

    A FastAPI backend and React interface, available in source-checkout deployments.

  • Report formats

    JSON, text, HTML, SARIF, JUnit, DOCX, and PDF — so findings land wherever your process already looks.

Packaging note. The PyPI package installs the fedstylevalidator Python modules, CLI entry point, and built-in rule packs. The repository-local backend and frontend apps are source-checkout workflows.

§ 04
Install

Getting started

Install from PyPI: 

pip install fedstylevalidator

Or as an isolated command-line install: 

pipx install fedstylevalidator

From a source checkout, which also gets you the backend and React UI: 

git clone https://github.com/eputnam77/FedStyleValidator.git
cd FedStyleValidator
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

§ 05
Details

Details

Repositorygithub.com/eputnam77/FedStyleValidator
Packagepypi.org/project/fedstylevalidator
Live demoHugging Face Space
RequirementsPython 3.11 through 3.13; Node 18+ only for the React UI from source
Input formatWord .docx
Output formatsJSON, text, HTML, SARIF, JUnit, DOCX, PDF
Rule packsFederal, FAA, DOT OGC, plain language, accessibility, external prose
LicenseSee LICENSE in the repository
AuthorEric Putnam