farcreate(1)

💖 farcreate(1) — the girlies' guide to making finite-state archives ✨

okay so bestie, welcome to farcreate(1), a User Commands classic, and honestly? it's giving "tool that just works." it's here to make you a finite-state archive out of all your input FSTs and i'm obsessed with it for you. 🎀

---

🌸 NAME 🌸

farcreate — create a finite-state archive from input FSTs 💅

---

✨ SYNOPSIS ✨

farcreate [OPTIONS] [in1.fst [[in2.fst ...] out.far]]

---

🦋 DESCRIPTION 🦋

Creates a finite-state archive from input FSTs.

that's it that's the tweet. you feed it FSTs, it hands you a FAR. slay. 🔥

---

👑 OPTIONS 👑

quick lil vibe check before we dive in, bestie: boolean options are chill like that — they accept either true or false as a value, or if you say literally nothing, they just implicitly take the value true. no cap.

• --far_type=TYPE — sets the FAR file format, and you gotta pick exactly one of default, stlist, or sttable. default: default. ✨
• --file_list_input[=BOOLEAN] — when this is on, every input file contains a list of files to be processed. very matryoshka of them honestly. default: false.
• --fst_align[=BOOLEAN] — write FST data aligned where appropriate. 🫶 default: false.
• --fst_compat_symbols[=BOOLEAN] — require symbol tables to match when appropriate. default: true.
• --fst_default_cache_gc[=BOOLEAN] — enable garbage collection of the cache. spring cleaning but make it FSTs. 🧹 default: true.
• --fst_default_cache_gc_limit=N — sets the cache byte size that triggers garbage collection. default: 1048576.
• --fst_error_fatal[=BOOLEAN] — if true, FST errors are fatal. if not, the returned objects get flagged as bad instead — like, FSTs come back with the kError property set to true, and FST weights get set so that Member() returns false. default: true.
• --fst_field_separator=STRING — sets the characters used as a separator between printed fields. default: " ".
• --fst_read_mode=STRING — sets the default file reading mode for mappable files, either "read" or "map". default: "read".
• --fst_verify_properties[=BOOLEAN] — verify fst properties queried by TestProperties. default: false.
• --fst_weight_parentheses=STRING — sets the characters enclosing the first weight of a printed composite weight (think pair weight, tuple weight, and derived classes) so that nested composite weights do their I/O properly. must have size 0 (none) or 2 (open and close parenthesis). default: no parentheses.
• --fst_weight_separator=CHARACTER — sets the character separator between printed composite weights. default: comma.
• --generate_keys=N — generate N digit numeric keys. default: use file basenames.
• --help[=BOOLEAN] — show usage information. default: false.
• --helpshort[=BOOLEAN] — show brief usage information (the lil snack-sized version). 🍓 default: false.
• --key_prefix=STRING — sets the prefix to prepend to keys. default: no prefix.
• --key_suffix=STRING — sets the suffix to append to keys. default: no suffix.
• --save_relabel_ipairs=FILENAME — save input relabel pairs to file. default: do not save.
• --save_relabel_opairs=FILENAME — save output relabel pairs to file. default: do not save.
• --tmpdir=PATHNAME — sets the temporary directory to use. default: /tmp.
• --v[=N] — sets the verbosity level. default: 0.

---

🌈 SEE ALSO 🌈

farcompilestrings(1), farequal(1), farextract(1), farinfo(1), farisomorphic(1), farprintstrings(1)

the whole friend group, periodt. 💜

---

okay that's the whole page, bestie — go make some archives, you're gonna eat 💅✨

🦋 this has been your girl, signing off with the important receipts: this is OpenFst 1.8.5, dated Mar 2026, and it's the farcreate(1) manual. mwah, take care of her 🎀💖