add_wchnstr - Linux


add_wchnstr is a lightweight utility for adding word chains to a given text file. It’s primarily used in natural language processing (NLP) tasks, such as text generation, language modeling, and text analysis. The word chains it adds are created using a Markov chain model.


add_wchnstr [OPTIONS] FILE


  • -o, –output-file : Specifies the output file name. Defaults to stdout (console).
  • -n, –order : Sets the Markov chain order. Defaults to 2.
  • -k, –min-freq : Sets the minimum frequency for a word to be included in the chain. Defaults to 2.
  • -m, –max-chain : Specifies the maximum length of the added word chains. Defaults to 5.
  • -d, –delimiter : Sets the delimiter used to separate words in the chain. Defaults to " ".
  • -h, –help: Displays help information.


Add word chains of order 3 with a minimum frequency of 3:

add_wchnstr -n 3 -k 3 input.txt

Save output to a file with a delimiter of "_":

add_wchnstr -o output.txt -d "_" input.txt

Common Issues

  • Ensure that the input file contains plain text.
  • Adjust the Markov chain order and minimum frequency based on the specific needs of the task.


Combine with grep to extract specific chains:

add_wchnstr -m 5 input.txt | grep "the cat"

Related Commands

  • markov: A command-line tool for generating text using Markov chains.
  • NLTK: A popular Python library for NLP.