An experimental, snappy, and keyboard-centric UI for interacting with AI agents and augmenting humans using AI!
Chat about any thing with any agent.
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.
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.
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.
- Install
ollama
. - Pull the model you require, e.g.
ollama pull llama3
. - Run the local ollama server:
ollama serve
. - Add the model to the config file (see below).
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)"
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:
![image](https://private-user-images.githubusercontent.com/5740731/332787659-94b6e50c-429a-4d17-99c2-affaa828f35b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjYwMTE4MzksIm5iZiI6MTcyNjAxMTUzOSwicGF0aCI6Ii81NzQwNzMxLzMzMjc4NzY1OS05NGI2ZTUwYy00MjlhLTRkMTctOTljMi1hZmZhYTgyOGYzNWIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkxMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MTBUMjMzODU5WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NDRiY2M3Zjk0MmY1ZTFjYWM2NzFjNGUyODdkZTNlNTZmMzQ0YTFlM2FiNjFjNWY4NGRmMjYyZTE2NmM4NzVjNSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.cr7VhfefBvFTJU-OcIQ_vG987hXo4sYgKwm0pliGWzs)
With this mapping in place, pressing Cmd+Enter will send a message to the LLM, and pressing Enter alone will create a new line.
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'
python -m elia_chat reset
cd ..
cd ..
# Running `cd ..` twice ensures that you are in the same directory as EliaPlus is in
del EliaPlus