Conlang GPT is a command line tool for creating, modifying and using constructed languages, powered by ChatGPT
⚠️ This tool is in early development. It is not ready for production use. Regardless, anyone who's generating fake languages in a business context should carefully consider their life choices, but this is fine because it's open source.
| Feature | Status |
|---|---|
| Automatically generate specifications for written or spoken languages | ✨ Alpha |
| Automatically or manually improve language specs iteratively | ✨ Alpha |
| Translate any text to or from the generated languages | ✨ Alpha |
| Generate vocabulary lazily | ✨ Alpha |
| Automatically update vocabulary when language specs change | ✨ Alpha |
| Support for all of OpenAI's chat models | ✨ Alpha |
pip install conlang-gpt
Languages are represented as two files:
- Guide: The purpose of the language guide is to describe how to use the language, including rules related to grammar and phonetics.
- Dictionary: The dictionary contains the vocabulary for the language. It is built up lazily as more and more text is translated.
Conlang GPT provides several commands:
$ conlang --help
Usage: conlang [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
create Create a constructed language.
improve Automatically improve the language.
modify Make specific changes to the language.
translate Translate text to or from a constructed language.
Before running any of them, set the OPENAI_API_KEY environment variable (keep the space in front to exclude the command from your history):
export OPENAI_API_KEY=sk...
Creates the first draft of a guide for a new language and writes it to a file.
$ conlang create --help
Usage: conlang create [OPTIONS]
Create a constructed language.
Options:
--design-goals TEXT
--guide TEXT
--model TEXT OpenAI model to use. Defaults to chatgpt-4o-latest.
--help Show this message and exit.
Attempts to automatically improve the language guide and dictionary. The resulting guide and dictionary are saved to the original input files.
$ conlang improve --help
Usage: conlang improve [OPTIONS]
Automatically improve the language.
Options:
--guide TEXT
--dictionary TEXT Enter the filename of the dictionary to use in
'example' mode.
--max-iterations INTEGER Max number of revisions to perform. Defaults
to 5.
--similarity-threshold FLOAT Maximum similarity between two words to be
considered the same. Defaults to 0.98.
--model TEXT OpenAI model to use. Defaults to
chatgpt-4o-latest.
--help Show this message and exit.
Makes a specific change to the language and updates the guide and dictionary.
$ conlang modify --help
Usage: conlang modify [OPTIONS]
Make specific changes to the language.
Options:
--guide TEXT
--dictionary TEXT Enter the filename of the dictionary to use in
'example' mode.
--changes TEXT
--similarity-threshold FLOAT Maximum similarity between two words to be
considered the same. Defaults to 0.98.
--model TEXT OpenAI model to use. Defaults to
chatgpt-4o-latest.
--help Show this message and exit.
Translates text between any language ChatGPT was trained on to and from the conlang. The language of the input text is automatically detected and used to dermine which language to translate to. If any problems are encountered while translating, the guide and dictionary will be repeatedly fixed until --max-improvements is reached.
$ conlang translate --help
Usage: conlang translate [OPTIONS]
Translate text to or from a constructed language.
Options:
--guide TEXT
--dictionary TEXT
--text TEXT
--max-improvements INTEGER Max number of relevant improvements to make to
the guide and dictionary. Defaults to 5.
--similarity-threshold FLOAT Maximum similarity between two words to be
considered the same. Defaults to 0.98.
--model TEXT OpenAI model to use
--embedding-model TEXT OpenAI model to use for word embeddings
--help Show this message and exit.