elia-chat 1.0.0

A powerful terminal user interface for interacting with large language models.

Elia

A powerful terminal user interface for interacting with large language models.

Supports hundreds of LLMs, including ChatGPT, Claude, and even models running locally through ollama.

Your conversations are stored locally in a SQLite database.

Installation

Install Elia with pipx:

pipx install elia

Depending on the model you wish to use, you may need to set one or more environment variables (e.g. OPENAI_API_KEY, ANTHROPIC_API_KEY, etc).

Quickstart

Launch Elia from the command line:

elia

Launch directly a new chat from the command line:

elia "What is the Zen of Python?"

Running local models

1. Install ollama.
2. Pull the model you require, e.g. ollama pull llama3.
3. Run the local ollama server: ollama serve.
4. Add the model to the config file (see below).

Configuration

The location of the configuration file is noted at the bottom of the options window (ctrl+o).

The example file below shows the available options, as well as examples of how to add new models.

# the model that is selected by default on launch
default_model = "gpt-3.5-turbo"
# the system prompt on launch
system_prompt = "You are a helpful assistant who talks like a pirate."

# example of adding local llama3 support
# only the `name` field is required here.
[[models]]
name = "ollama/llama3"

# example of add a groq model, showing some other fields
[[models]]
name = "groq/llama2-70b-4096"
display_name = "Llama 2 70B"  # appears in UI
provider = "Groq"  # appears in UI
temperature = 1.0  # high temp = high variation in output
max_retries = 0  # number of retries on failed request

Import from ChatGPT

Export your conversations to a JSON file using the ChatGPT UI, then import them using the import command.

elia import 'path/to/conversations.json'

Wiping the database

elia reset

Uninstalling

pipx uninstall elia