项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2446
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 可执行 uvx 命令的环境(README 仅给出 uvx 安装方式)
- Python 3.11 或更高版本(仅 speak 语音朗读扩展需要)
- 一个可用的 LLM 提供商 API Key,或本地运行的 Ollama 服务
安装与启动步骤
-
1确认运行环境
oterm 通过 uvx 直接运行,无需手动建虚拟环境;若想使用语音朗读扩展,需 Python 3.11 或更新版本。
-
2启动 oterm
执行 README 中给出的唯一安装命令,uvx 会自动拉取并运行 oterm,终端进入 TUI 界面。
uvx oterm -
3可选启用语音朗读
需要朗读回复时安装 speak 扩展,回复流式输出时会通过 piper 朗读;基础安装不受影响。
uvx "oterm[speak]" -
4配置提供商密钥
按 pydantic-ai 支持的方式设置对应提供商的 API Key,设置后该提供商才会出现在新建聊天的下拉框中。
如何确认成功
终端出现 oterm 的 TUI 聊天界面,且「新建聊天」下拉框中能看到已配置密钥的提供商。
常见问题
Q:oterm 只能配合 Ollama 使用吗?
A:不是。现已通过 pydantic-ai 支持 OpenAI、Anthropic、Google、Groq、Mistral、DeepSeek、OpenAI 兼容端点以及 Ollama 等,设置对应 API Key 后即会在下拉框出现。
Q:怎样让模型把回复读出来?
A:用 uvx "oterm[speak]" 运行带 speak 扩展的版本,回复流式生成时会通过 piper 以 GLaDOS 音色朗读,需要 Python 3.11 或更高版本。
Q:安装、配置和使用文档在哪里?
A:README 给出的完整说明地址是 https://ggozad.github.io/oterm/ ,命令行为 uvx oterm。
Q:升级后原来的用法有变化吗?
A:多提供商支持和 MCP 重写都是破坏性更新,oterm 不再只面向 Ollama,升级后请按新的提供商方式配置。
注意事项
- README 只提供了 uvx 这一种安装方式,其他安装方式需查阅官方文档。
- 多提供商支持属于破坏性变更(breaking),旧配置可能需要调整。
- speak 语音扩展要求 Python 3.11 及以上,基础安装无此要求。
核心亮点
- 原生终端界面,无需浏览器,启动快、资源占用低,适合 SSH 远程开发环境
- 支持多模型提供商和自定义端点,灵活切换不同 LLM 服务
- 提供会话持久化与历史记录,方便回溯和复用之前的对话上下文
不足之处
- 功能相比成熟 IDE 插件(如 Continue)仍显精简,插件生态尚未建立
- 文档/社区待观察,教程和示例相对有限,新手上手可能需摸索
适用场景
- 开发者在编写代码时快速询问代码逻辑或生成正则表达式
- 运维人员通过 SSH 登录服务器后,直接在终端进行日志分析或命令解释
- 需要批量处理文本任务(如翻译、格式化)且希望保留终端工作流的场景
替代项目
ShellGPT、aichat、llm
上一篇:elia
下一篇:chat-with-gpt
同类项目推荐
HubFrontend
开源
一个界面搞定 GPT 问答和 MJ 绘画,省去来回切换
集成 GPT 问答、Midjourney 绘画等一站式服务的系统
chat_gpt_oicq
开源
在 QQ 里养一只猫娘 AI,随时陪你聊天
ChatGPT qq机器人 谁不想拥有一只可爱的猫娘呢~
AICat
开源
用原生 SwiftUI 在苹果全家桶上畅聊 ChatGPT
Multiplatform Client for ChatGPT using SwiftUI, support iOS, iPadOS & MacOS
stable-diffusion-webui-chatgpt-u···
开源
在 Stable Diffusion 界面里直接调用 ChatGPT,写提示词不用再切窗口。
Enables use of ChatGPT directly from the UI
Talk2GPT
开源
让 GPT-3 记住你,并支持语音对话和免费画图
GPT-3 client for Windows and Unix with memories management that supports both text a···
awesome-chatgpt
开源
一站式找齐ChatGPT好工具,省时省力
ChatbotX
开源
开源多渠道 AI 营销助手,替代 ManyChat,统一管理客户对话
Open-source ManyChat alternative, built for AI. Omnichannel marketing across WhatsAp···
Llama-macOS
开源
Mac 上双击就能跑的本地大模型聊天应用
A cosy home for your LLMs.
AIKON
开源
让 2007 年诺基亚功能机用上 Claude 和 ChatGPT
A 2007 Nokia can't search Google anymore, so I gave it Claude, ChatGPT, Gemini and G···
