An experimental, snappy, and keyboard-centric UI for interacting with AI agents and augmenting humans using AI!
Chat about any thing with any agent.

Introduction

elia+ (powered by, modified from, and credited to elia) is an application for interacting with LLMs which runs entirely in your terminal, and is designed to be keyboard-focused, efficient, and fun to use! It stores your conversations in a local SQLite database, and allows you to interact with a variety of models. Speak with proprietary models such as ChatGPT and Claude, or with local models running through ollama or LocalAI.

Installation

Clone Elia+ with Git and install the requirements with pip:

git clone https://github.com/gooddavvy/EliaPlus.git
cd EliaPlus
pip install -r requirements.txt

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, GEMINI_API_KEY etc).

Important Note: Usage of Elia+ may not work as expected if you have the elia_chat (Regular Elia) package installed. You might consider temporarily uninstalling elia_chat if you already have it installed.

Quickstart

After doing the entire cloning step, launch Elia+ from the command line:

python -m elia_chat

Launch a new chat inline (under your prompt) with -i/--inline:

python -m elia_chat -i "What is the Zen of Python?"

Launch a new chat in full-screen mode:

python -m elia_chat "Tell me a cool fact about lizards!"

Specify a model via the command line using -m/--model:

python -m elia_chat -m gpt-4o

Options can be combined - here's how you launch a chat with Gemini 1.5 Flash in inline mode (requires GEMINI_API_KEY environment variable).

python -m elia_chat -i -m gemini/gemini-1.5-flash-latest "How do I call Rust code from Python?"

Remember, for now, you can't use Elia+ unless you are in the EliaPlus directory that you cloned.

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 ID or name of the model that is selected by default on launch
default_model = "gpt-4o"
# the system prompt on launch
system_prompt = "You are a helpful assistant who talks like a pirate."
# change the syntax highlighting theme of code in messages
# choose from https://pygments.org/styles/
# defaults to "monokai"
message_code_theme = "dracula"

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

# example of a model running on a local server, e.g. LocalAI
[[models]]
name = "openai/some-model"
api_base = "http://localhost:8080/v1"
api_key = "api-key-if-required"

# 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

# example of multiple instances of one model, e.g. you might
# have a 'work' OpenAI org and a 'personal' org.
[[models]]
id = "work-gpt-3.5-turbo"
name = "gpt-3.5-turbo"
display_name = "GPT 3.5 Turbo (Work)"

[[models]]
id = "personal-gpt-3.5-turbo"
name = "gpt-3.5-turbo"
display_name = "GPT 3.5 Turbo (Personal)"

Changing keybindings

Right now, keybinds cannot be changed. Terminals are also rather limited in what keybinds they support. For example, pressing Cmd+Enter to send a message is not possible (although we may support a protocol to allow this in some terminals in the future).

For now, I recommend you map whatever key combo you want at the terminal emulator level to send \n. Here's an example using iTerm:

With this mapping in place, pressing Cmd+Enter will send a message to the LLM, and pressing Enter alone will create a new line.

Import from ChatGPT

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

python -m elia_chat import 'path/to/conversations.json'

Wiping the database

python -m elia_chat reset

Uninstalling

cd ..
cd ..
# Running `cd ..` twice ensures that you are in the same directory as EliaPlus is in
del EliaPlus