elia is a Python-based terminal UI to chat with various LLMs, including ChatGPT, Claude, and local models via ollama, storing conversations in SQLite.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
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.
How it works
elia provides a terminal user interface to send prompts to multiple models, supports local and hosted models, and stores conversations locally. It can connect to models via environment variables (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY) and can be configured with a TOML file listing models and settings. It includes features like theme customization, and a keybinding system that is currently fixed.
Getting started
Install Elia with pipx:
pipx install --python 3.11 elia-chat
Configure environment variables as needed (e.g., OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY).
Quickstart:
elia
Inline chat:
elia -i "What is the Zen of Python?"
Full-screen chat:
elia "Tell me a cool fact about lizards!"
Specify a model:
elia -m gpt-4o
Inline with a specific model example:
elia -i -m gemini/gemini-1.5-flash-latest "How do I call Rust code from Python?"
Recent releases
Latest releases include:
- 1.10.0 (2024-09-14): Added theme system, user-defined themes, theme directory listing, several builtin themes, and tooltips.
- 1.9.0 (2024-09-08): Improved responsiveness, Vim key support for agent responses, upgraded Textual, fixed crash when no clipboard mechanism is installed.
- 1.8.0 (2024-06-20): Claude 3.5 Sonnet support added.
- 1.7.0 (2024-05-22): Renaming chats feature.
- 1.6.1 (2024-05-22): Fixed temperature parameter handling.
Full changelog: https://github.com/darrenburns/elia/compare/1.6.0...1.6.1
Traction
Stars: 2478, Forks: 156, Open issues: 24
Behind the repo
Originating organization is Darren Burns; repository focuses on a Python terminal UI for LLMs with local model support via Ollama, and integration with various providers.
Caveats
License: Apache-2.0 Created: 2023-05-04 Last push: 2024-10-10 Notes: Requires environment variables for model APIs and may require Ollama for local models; configuration is via a TOML file and an options UI to locate the themes directory.