elia

环境要求

• pipx（用于安装命令行 Python 应用）
• Python 3.11（安装命令中显式指定 --python 3.11）
• 一个可用的终端环境（Elia 完全运行在终端中）
• 至少一个模型的访问密钥，如 OPENAI_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEY 之一
• 可选：本地模型需先安装 ollama

安装与启动步骤

1. 1用 pipx 安装 Elia

   README 指定的唯一安装方式，通过 pipx 安装 elia-chat 包，并强制使用 Python 3.11。安装完成后 elia 命令即可用。

   pipx install --python 3.11 elia-chat

   复制

2. 2设置模型密钥

   按你要用的模型设置对应环境变量，例如 OpenAI 用 OPENAI_API_KEY、Claude 用 ANTHROPIC_API_KEY、Gemini 用 GEMINI_API_KEY。只需设置实际使用的那个。

   export OPENAI_API_KEY=sk-xxxxxxxx
   export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx
   export GEMINI_API_KEY=xxxxxxxx

   复制

3. 3启动 Elia

   直接在命令行运行 elia 启动终端界面。对话会保存在本地 SQLite 数据库中。

   elia

   复制

4. 4内联模式提问

   用 -i/--inline 在当前提示符下方内联开启新对话，不占满整个屏幕，适合顺手问一句。

   elia -i "What is the Zen of Python?"

   复制

5. 5指定模型启动

   用 -m/--model 指定要使用的模型，例如 gpt-4o。选项可以组合使用。

   elia -m gpt-4o

   复制

6. 6组合选项调用 Gemini

   内联模式加模型名一起用，需先设置 GEMINI_API_KEY 环境变量。

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

   复制

7. 7接入本地模型

   先用 ollama 拉取模型并启动本地服务，再到配置文件中添加该模型；配置文件路径可在选项窗口底部查看。

   ollama pull llama3
   ollama serve

   复制

8. 8查看并编辑配置

   在 Elia 内按 ctrl+o 打开选项窗口，窗口底部会显示配置文件位置，按其中的 TOML 示例添加自定义模型。

关键配置

如何确认成功

运行 elia 后出现终端对话界面即为成功；在界面内按 ctrl+o 打开选项窗口，底部会显示配置文件路径。

常见问题

注意事项

• 安装时务必带 --python 3.11，README 明确要求 Python 3.11。
• 对话数据保存在本地 SQLite 数据库，不会上传到第三方（模型本身请求除外）。
• 使用哪种模型就需要设置对应的环境变量，缺密钥时对应模型不可用。
• 本地模型需保证 ollama serve 已在运行，否则配置文件中的模型无法连接。