oterm

在终端里直接聊大模型,告别网页切换,提升编码效率

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 141 🐛 待处理 3 👀 关注 15
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2446
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

oterm 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队ggozad
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型anthropic,chatbot,llm,mcp,ollama,openai,pydantic-ai,python,terminal,textual,tui
GitHub 星标★ 2446
上线时间2023-10-10 00:00:00
代码更新2026-11-06
仓库体积36.4 MB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数9

项目介绍

oterm 是一个专为大型语言模型设计的终端客户端,旨在将 LLM 的交互体验从网页或 IDE 插件迁移到轻量级的命令行环境中。它解决了开发者在终端中频繁切换上下文、需要快速调用模型进行代码解释、文本生成或问题解答时的效率问题。核心能力包括:支持多种主流 LLM 提供商(如 OpenAI、Anthropic 等)的接入,提供流式响应、对话历史管理、多会话并行、以及可定制的提示词模板。通过简洁的 TUI(文本用户界面),用户可以在不离开终端的情况下完成与模型的深度交互,并方便地将输出复制到代码或文档中。项目基于 Python 构建,强调可配置性和扩展性,适合开发者、运维人员以及所有偏好键盘操作的技术用户。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2446

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 5 分钟 部署方式:命令行工具 4 步

环境要求

  • 可执行 uvx 命令的环境(README 仅给出 uvx 安装方式)
  • Python 3.11 或更高版本(仅 speak 语音朗读扩展需要)
  • 一个可用的 LLM 提供商 API Key,或本地运行的 Ollama 服务

安装与启动步骤

  1. 1确认运行环境

    oterm 通过 uvx 直接运行,无需手动建虚拟环境;若想使用语音朗读扩展,需 Python 3.11 或更新版本。

  2. 2启动 oterm

    执行 README 中给出的唯一安装命令,uvx 会自动拉取并运行 oterm,终端进入 TUI 界面。

    uvx oterm
  3. 3可选启用语音朗读

    需要朗读回复时安装 speak 扩展,回复流式输出时会通过 piper 朗读;基础安装不受影响。

    uvx "oterm[speak]"
  4. 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 绘画等一站式服务的系统

★ 175 2026-08-09
chat_gpt_oicq 开源

在 QQ 里养一只猫娘 AI,随时陪你聊天

ChatGPT qq机器人 谁不想拥有一只可爱的猫娘呢~

★ 279 2026-08-09
AICat 开源

用原生 SwiftUI 在苹果全家桶上畅聊 ChatGPT

Multiplatform Client for ChatGPT using SwiftUI, support iOS, iPadOS & MacOS

★ 287 2026-08-09
Talk2GPT 开源

让 GPT-3 记住你,并支持语音对话和免费画图

GPT-3 client for Windows and Unix with memories management that supports both text a···

★ 89 2026-08-09
ChatbotX 开源

开源多渠道 AI 营销助手,替代 ManyChat,统一管理客户对话

Open-source ManyChat alternative, built for AI. Omnichannel marketing across WhatsAp···

★ 1084 2026-08-09
Llama-macOS 开源

Mac 上双击就能跑的本地大模型聊天应用

A cosy home for your LLMs.

★ 1744 2026-09-16
AIKON 开源

让 2007 年诺基亚功能机用上 Claude 和 ChatGPT

A 2007 Nokia can't search Google anymore, so I gave it Claude, ChatGPT, Gemini and G···

★ 388 2026-10-03