https://github.com/rahji/speachy
A command-line program for returning words, from a text file, that match specific parts of speech tags
https://github.com/rahji/speachy
bubbletea command-line golang natural-language-processing nlp nlp-keywords-extraction nlp-parsing parts-of-speech
Last synced: 2 months ago
JSON representation
A command-line program for returning words, from a text file, that match specific parts of speech tags
- Host: GitHub
- URL: https://github.com/rahji/speachy
- Owner: rahji
- Created: 2024-11-20T04:03:06.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-11-20T04:56:16.000Z (7 months ago)
- Last Synced: 2025-03-29T08:43:37.459Z (3 months ago)
- Topics: bubbletea, command-line, golang, natural-language-processing, nlp, nlp-keywords-extraction, nlp-parsing, parts-of-speech
- Language: Go
- Homepage:
- Size: 24.4 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Speachy
Speachy is a command-line tool that allows you to get a list of words, from your text,
that match specific parts of speech.
## Examples
View a list of all types of adjectives from a text file:
```
speachy -i inputfile.txt JJ,JJR,JJS
```
Speachy will also take the text from STDIN, if you leave the input filename flag off of the command:
```
cat inputfile.txt | speachy JJS
```
Get a lowercase unique list by piping the output to a few unix commands:
```
cat inputfile.txt | speachy UH | tr A-Z a-z | sort | uniq
```
You can also output the words to a text file:
*(If you leave the list of part of speech tags off of the command, Speachy
will present an interactive list from which to choose tags.)*
```
speachy -i inputfile.txt -o outputfile.txt
```
## Installation
1. Download the appropriate archive file from the [Releases](releases) page.
2. Place the `speachy` executable somewhere in your path
3. Run it from a terminal window as described below. On MacOS, use the Terminal app. On Windows, you might need to [download Windows Terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701?hl=en-us&gl=us&rtc=1) from Microsoft.
Or, if you have `go` installed:
```bash
go install github.com/rahji/speachy@latest
```
## Usage
```
speachy [OPTIONS] [item1,item2,...]
-i, --infile string input file (if not specified, reads from STDIN)
-o, --outfile string optional output file
-h, --help show help message
The optional argument is a comma-separated list of abbreviations for
parts of speech to find in the text. If none are specified,
an interactive list is presented.
CC conjunction, coordinating
CD cardinal number
DT determiner
EX existential there
FW foreign word
IN conjunction, subordinating or preposition
JJ adjective
JJR adjective, comparative
JJS adjective, superlative
LS list item marker
MD verb, modal auxiliary
NN noun, singular or mass
NNP noun, proper singular
NNPS noun, proper plural
NNS noun, plural
PDT predeterminer
POS possessive ending
PRP pronoun, personal
PRP$ pronoun, possessive
RB adverb
RBR adverb, comparative
RBS adverb, superlative
RP adverb, particle
SYM symbol
TO infinitival to
UH interjection
VB verb, base form
VBD verb, past tense
VBG verb, gerund or present participle
VBN verb, past participle
VBP verb, non-3rd person singular present
VBZ verb, 3rd person singular present
WDT wh-determiner
WP wh-pronoun, personal
WP$ wh-pronoun, possessive
WRB wh-adverb
```
## Thanks
All the Natural Language Processing work is done by Go [prose package](https://github.com/jdkato/prose). Thanks, too, to Charm for the [Bubble Tea](https://github.com/charmbracelet/bubbletea) package for making the command-line fun. Also thanks to [Go](https://go.dev/), a fun language to learn and use.