📸 演示

🪄 功能

• 语法高亮
• 聊天历史
• 将聊天保存到文件
• Vim 键位绑定（最常用的操作）
• 从/到剪贴板复制文本（仅在提示符中有效）
• 多种后端支持
• 自动加载上次保存的聊天到历史记录

💎 支持的后端

• ChatGPT
• llama.cpp
• ollama

🚀 安装

📥 二进制发布

你可以从发布页面下载预编译的二进制文件。

📦 crates.io

tenere 可以通过 crates.io 安装：

cargo install tenere

❄️ NixOS / Nix

Tenere 已包含在 nixpkgs 中，可以通过 configuration.nix 进行安装：

environment.systemPackages = with pkgs; [
  tenere
];

对于非 NixOS 系统，可以直接使用以下命令安装：

nix-env -iA nixpkgs.tenere

📱 移动端（nix-on-droid）

Tenere 可以通过 nix-on-droid 在 Android 上运行（演示）。

设置步骤（教程）：

1. 从 F-Droid 安装 nix-on-droid。
2. 将 tenere 添加到 .config/nixpkgs/nix-on-droid.nix 文件中的包列表。
3. 运行 nix-on-droid switch。
4. 在 .config/tenere/config.toml 中创建你的配置文件。

🍺 Homebrew

brew install tenere

⚒️ 从源码构建

要从源码构建，你需要 Rust 编译器和 Cargo 包管理器。

安装好 Rust 和 Cargo 后，运行以下命令进行构建：

cargo build --release

这将生成一个可执行文件 target/release/tenere，你可以将其复制到 $PATH 中的某个目录。

⚙️ 配置

Tenere 可以通过 TOML 配置文件进行配置。默认情况下，配置文件位于：

• Linux: $HOME/.config/tenere/config.toml 或 $XDG_CONFIG_HOME/tenere/config.toml
• Mac: $HOME/Library/Application Support/tenere/config.toml
• Windows: ~/AppData/Roaming/tenere/config.toml

🛠 自定义配置路径

你也可以使用 -c 标志指定自定义的配置文件路径，从而覆盖默认的配置文件位置。

使用示例

# 使用默认配置路径
tenere

# 指定自定义配置路径
tenere -c ~/path/to/custom/config.toml

通用设置

以下是可用的通用设置：

• llm: 大语言模型名称。可能的值为：
  • chatgpt
  • llamacpp
  • ollama

llm  = "chatgpt"

键位绑定

Tenere 支持自定义键位绑定。你可以通过更新配置文件中的 [key_bindings] 部分来修改部分默认键位绑定。以下是一个包含默认键位绑定的示例：

[key_bindings]
show_help = '?'
show_history = 'h'
new_chat = 'n'

ℹ️ 注意

为了避免与 Vim 键位绑定冲突，除了帮助键 ? 外，其他键都需要使用 ctrl + 键。

ChatGPT

要使用 chatgpt 作为后端，你需要提供 OpenAI 的 API 密钥。有两种方法可以做到这一点：

1. 设置包含你的 API 密钥的环境变量：

export OPENAI_API_KEY="YOUTR KEY HERE"

或者

2. 将你的 API 密钥添加到配置文件中：

[chatgpt]
openai_api_key = "Your API key here"
model = "gpt-3.5-turbo"
url = "https://api.openai.com/v1/chat/completions"

默认模型设置为 gpt-3.5-turbo。更多信息请参阅 OpenAI 文档。

llama.cpp

要使用 llama.cpp 作为后端，你需要提供指向服务器的 URL：

[llamacpp]
url = "http://localhost:8080/v1/chat/completions"

如果你在服务器上配置了 API 密钥，则也需要提供它：

设置环境变量：

export LLAMACPP_API_KEY="YOUTR KEY HERE"

或者

将你的 API 密钥添加到配置文件中：

[llamacpp]
url = "http://localhost:8080/v1/chat/completions"
api_key = "Your API Key here"

有关 llama.cpp API 的更多信息，请参阅 这里。

Ollama

要使用 ollama 作为后端，你需要提供指向带有模型名称的服务器的 URL：

[ollama]
url = "http://localhost:11434/api/chat"
model = "Your model name here"

有关 ollama API 的更多信息，请参阅 这里。

⌨️ 键位绑定

全局

这些是无论焦点块为何都适用的默认键位绑定。

ctrl + n: 开始一个新的聊天，并将之前的聊天保存到历史记录中，同时保存到数据目录下的 tenere.archive-i 文件中。

Tab: 切换焦点。

j 或 向下箭头键: 向下滚动。

k 或 向上箭头键: 向上滚动。

ctrl + h: 显示聊天历史。按 Esc 键关闭。

ctrl + t: 停止流式响应。

q 或 ctrl + c: 退出应用。

?: 显示帮助弹出窗口。按 Esc 键关闭。

提示符

有三种模式，类似于 Vim：Normal、Visual 和 Insert。

插入模式

Esc: 切换回正常模式。

Enter: 创建新行。

Backspace: 删除前一个字符。

正常模式

Enter: 提交提示。

h 或 左键: 光标向后移动一个字符。

j 或 下键: 光标向下移动。

k 或 上键: 光标向上移动。

l 或 右键: 光标向前移动一个字符。

w: 光标向右移动一个单词。

b: 光标向左移动一个单词。

0: 光标移动到行首。

$: 光标移动到行尾。

G: 移动到文档末尾。

gg: 移动到文档开头。

a: 在光标后插入。

A: 在行尾插入。

i: 在光标前插入。

I: 在行首插入。

o: 在当前行下方插入新行。

O: 在当前行上方插入新行。

x: 删除光标下的一个字符。

dd: 剪切当前行。

D: 删除当前行及之后的内容。

dw: 删除光标右侧的一个单词。

db: 删除光标左侧的一个单词。

d0: 删除光标到行首的内容。

d$: 删除光标到行尾的内容。

C: 修改到行尾的内容。

cc: 修改当前行。

c0: 修改光标到行首的内容。

c$: 修改光标到行尾的内容。

cw: 修改下一个单词。

cb: 修改光标左侧的一个单词。

u: 撤销操作。

p: 粘贴。

可视模式

v: 切换到可视模式。

y: 复制选中的文本。

贡献

• 不接受无意义的提交。
• 请先创建议题或进行讨论后再提交拉取请求。
• 保持 PR 小而集中。

⚖️ 许可证

GNU 通用公共许可证 v3.0 或更高版本

Tenere 快速上手指南

Tenere 是一款基于终端用户界面（TUI）的大语言模型（LLM）客户端，支持语法高亮、聊天历史管理、Vim 键位绑定以及多种后端（ChatGPT、llama.cpp、Ollama）。

环境准备

• 操作系统：Linux、macOS、Windows 或 Android (需 nix-on-droid)。
• 前置依赖：
  • 若通过包管理器安装，无需额外依赖。
  • 若从源码编译，需安装 Rust 和 Cargo。
• 后端服务：根据选择的后端，需确保以下服务可用：
  • ChatGPT：有效的 OpenAI API Key。
  • llama.cpp：运行中的 llama.cpp server。
  • Ollama：运行中的 Ollama 服务及已拉取的模型。

安装步骤

方式一：使用包管理器（推荐）

macOS (Homebrew):

brew install tenere

Rust 用户 (Cargo):

cargo install tenere

NixOS / Nix:

# 系统级安装 (configuration.nix)
environment.systemPackages = with pkgs; [ tenere ];

# 或直接安装
nix-env -iA nixpkgs.tenere

Android (nix-on-droid): 在 .config/nixpkgs/nix-on-droid.nix 中添加 tenere 到 packages 列表，然后运行：

nix-on-droid switch

方式二：下载预编译二进制

访问 Release 页面 下载对应系统的二进制文件，解压后将可执行文件放入 $PATH 目录。

方式三：源码编译

git clone https://github.com/pythops/tenere.git
cd tenere
cargo build --release
# 生成的可执行文件位于 target/release/tenere

基本使用

1. 配置后端

Tenere 默认读取配置文件，也支持环境变量。配置文件路径：

• Linux: $HOME/.config/tenere/config.toml
• macOS: $HOME/Library/Application Support/tenere/config.toml
• Windows: ~/AppData/Roaming/tenere/config.toml

场景 A：使用 ChatGPT

创建或编辑配置文件 config.toml：

llm = "chatgpt"

[chatgpt]
openai_api_key = "sk-你的 API KEY"
model = "gpt-3.5-turbo"

或者设置环境变量： export OPENAI_API_KEY="sk-你的 API KEY"

场景 B：使用 Ollama

llm = "ollama"

[ollama]
url = "http://localhost:11434/api/chat"
model = "llama3" # 替换为你本地已安装的模型名称

场景 C：使用 llama.cpp

llm = "llamacpp"

[llamacpp]
url = "http://localhost:8080/v1/chat/completions"
# 如果服务器设置了密钥，在此处添加 api_key

2. 启动与交互

在终端输入以下命令启动：

tenere

常用操作指南：

• 切换焦点：按 Tab 键在输入框和历史记录间切换。
• 输入模式 (Insert Mode)：类似 Vim，直接输入文本。
  • Esc：返回正常模式。
  • Enter：换行。
• 正常模式 (Normal Mode)：
  • j / k：上下滚动。
  • h / l：左右移动光标。
  • Enter：提交提示词（发送消息）。
  • ctrl + n：新建聊天（自动保存当前会话）。
  • ctrl + h：查看历史会话。
  • ?：显示帮助菜单。
  • q 或 ctrl + c：退出程序。

提示：大部分键位绑定遵循 Vim 习惯。若在输入框外，多数单字母键用于导航；在输入框内（Insert 模式），可直接打字。