# eschluntz/compress

Text compression for generating keyboard expansions

Repository: https://github.com/eschluntz/compress
Canonical: https://ross.abutalabs.com/products/eschluntz-compress
Language: Python
License Family: other
Last push: 2023-09-30T17:24:33+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 1789, "days_push": 1068, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1415, forks 30 (observed 2026-08-28T04:04:39.742873+00:00)

## What it is
A Python tool that analyzes a corpus of your own writing to find common n-grams and suggest text-expansion abbreviations ranked by characters saved. It generates config files for Autokey, a Linux keyboard shortcut program, and can parse Slack data exports as a corpus.

## Use cases
- generate typing shortcuts from my own writing
- create text expansion abbreviations for email and slack
- find which phrases I should abbreviate to type faster
- turn my slack message history into a text expansion corpus
- auto-generate autokey config files for abbreviations

## When to choose
- you type a lot of repetitive text in email or Slack on Linux
- you want data-driven suggestions for which abbreviations save the most keystrokes
- you already use or want to use Autokey for text expansion

## When to avoid
- you need text expansion on macOS or Windows (Autokey is Linux-only)
- you want a polished GUI tool rather than a script with manual post-processing
- you need a maintained project with a license or active development

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: nlp, parser, developer-tools, workflow-automation
- domain: developer-tools
- platform: python, cli
- tags: text-expansion, keyboard-shortcuts, autokey, typing-efficiency, ngram-analysis, natural-language-processing, automation, command-line, linux

## Member repositories
- eschluntz/compress (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:39.742873+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:08.758220+00:00, confidence not recorded.
  - readme: https://github.com/eschluntz/compress (fetched 2026-08-28T04:04:39.742873+00:00, sha 7572eb808bb3)
- Data as of 2026-08-30T08:39:29.467469+00:00.