Documentation Index
Fetch the complete documentation index at: https://mintlify.com/simonw/LLM/llms.txt
Use this file to discover all available pages before exploring further.
Aliases let you refer to any model — language or embedding — by a short custom name instead of its full ID. LLM ships with a set of built-in aliases for OpenAI models, and you can add your own with a single command.
Listing Aliases
This shows every alias currently configured, including built-in ones:
4o : gpt-4o
chatgpt-4o : chatgpt-4o-latest
4o-mini : gpt-4o-mini
4.1 : gpt-4.1
4.1-mini : gpt-4.1-mini
4.1-nano : gpt-4.1-nano
3.5 : gpt-3.5-turbo
chatgpt : gpt-3.5-turbo
chatgpt-16k : gpt-3.5-turbo-16k
3.5-16k : gpt-3.5-turbo-16k
4 : gpt-4
gpt4 : gpt-4
4-32k : gpt-4-32k
gpt-4-turbo-preview : gpt-4-turbo
4-turbo : gpt-4-turbo
4t : gpt-4-turbo
gpt-4.5 : gpt-4.5-preview
3.5-instruct : gpt-3.5-turbo-instruct
chatgpt-instruct : gpt-3.5-turbo-instruct
ada : text-embedding-ada-002 (embedding)
ada-002 : text-embedding-ada-002 (embedding)
3-small : text-embedding-3-small (embedding)
3-large : text-embedding-3-large (embedding)
3-small-512 : text-embedding-3-small-512 (embedding)
3-large-256 : text-embedding-3-large-256 (embedding)
3-large-1024 : text-embedding-3-large-1024 (embedding)
Adding an Alias
llm aliases set <alias> <model-id>
mini for gpt-4o-mini:
llm aliases set mini gpt-4o-mini
llm -m mini 'An epic Greek-style saga about a cheesecake'
-q:
llm aliases set mini -q 4o -q mini
llm aliases set oai ada-002
llm embed -c 'hello world' -m oai
Removing an Alias
This deletes the alias but does not affect the underlying model.
The Aliases File
Aliases are stored in an aliases.json file inside the LLM configuration directory.
Find the file path:
View the file contents:
cat "$(llm aliases path)"
{
"mini": "gpt-4o-mini",
"oai": "text-embedding-ada-002"
}
User-defined aliases in aliases.json are merged with built-in aliases at runtime. Built-in aliases (like 4o for gpt-4o) are always available and do not appear in this file unless you override them.