# 使用 Homebrew, Nix 安装 oterm

查看 oterm 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:oterm
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install oterm
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#oterm
```

  证据: nixpkgs package indexes: pkgs/by-name/ot/oterm/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:oterm
- **软件包管理器:** Homebrew
- **版本:** 0.23.0
- **来源摘要:** Terminal client for Ollama
- **主页:** <https://github.com/ggozad/oterm>
- **最后更新:** 2026-08-01T16:22:13Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- oterm (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.23.0
## 项目历史与用法

oterm is a Python terminal UI for chatting with LLMs. It began as a text-based terminal client for Ollama and evolved into a multi-provider terminal client for Ollama, OpenAI, Anthropic, Google, Groq, Mistral, Cohere, Bedrock, OpenAI-compatible endpoints, and other pydantic-ai-supported providers.

### 项目历史

GitHub records `ggozad/oterm` as created on 2023-10-10, during the wave of local-LLM tooling around Ollama. Early package descriptions and PyPI metadata framed it as a text-based terminal client for Ollama with persistent chat sessions, SQLite storage, model selection, system prompts, and parameter customization.

The 2026 release line changed the project's scope. Release 0.15.0, published on 2026-04-27, is described as the multi-provider release: chats moved through pydantic-ai, MCP integration was rewritten, the UI was refreshed, streaming improved, and old Ollama-only assumptions such as an internal pull-model command were removed. The README describes oterm as a terminal client for Ollama, OpenAI, Anthropic, and any pydantic-ai-supported provider.

### 采用历史

oterm's adoption follows the developer interest in local and terminal-first LLM workflows. It is listed in the Ollama repository's terminal/CLI ecosystem list, and Homebrew/Nix packaging made it installable in the same package-manager channels as other developer CLIs.

The tool's multi-provider turn broadened its appeal from an Ollama companion to a terminal chat front end that can sit over local models, hosted APIs, and OpenAI-compatible servers such as vLLM, LM Studio, llama.cpp, OpenRouter, and LiteLLM.

### 使用方式

Users install and run `oterm` to get a terminal UI with persistent chat sessions, provider/model selection, streamed Markdown output, configurable system prompts and parameters, and optional MCP tool configuration. The documented config locations in the av.db input show it stores per-user configuration under the platform's application data directory, with environment-variable overrides for secrets and data directory selection.

For package nerds, the interesting usage pattern is that oterm packages a full TUI experience as a CLI entry point: the Python package is not merely a library, but an end-user application distributed through PyPI-style tooling and system package managers.

### 为什么软件包爱好者会关心

oterm is a good example of the fast-moving LLM CLI package category: a small terminal app can quickly become a package-manager target because users want one-command installation, upgrades, and config discovery. Its 0.15.0 migration also shows how model-provider abstraction moved from app-specific integrations to library-mediated provider layers such as pydantic-ai.

### 时间线

- 2023-10-10: GitHub records creation of `ggozad/oterm`.
- 2024: PyPI release 0.6.0 described oterm as a text-based terminal client for Ollama with persistent SQLite sessions and model customization.
- 2026-04-27: release 0.15.0 changed oterm into a multi-provider pydantic-ai-based terminal client and rewrote MCP configuration.
- 2026-06-30: release 0.20.0 updated pydantic dependencies and improved Modelfile-based prompt/parameter prepopulation.

### Related projects

- Ollama is the original local-model runtime oterm was built around.
- pydantic-ai became the provider abstraction layer for oterm's multi-provider architecture.
- MCP-compatible configuration connects oterm to the same tool-server ecosystem used by desktop AI clients and editors.

### 来源

- <https://api.github.com/repos/ggozad/oterm>
- <https://formulae.brew.sh/formula/oterm>
- <https://ggozad.github.io/oterm/>
- <https://github.com/ggozad/oterm>
- <https://github.com/ggozad/oterm/releases/tag/0.15.0>
- <https://github.com/ggozad/oterm/releases/tag/0.20.0>
- <https://github.com/ollama/ollama>
- <https://pypi.org/project/oterm/0.6.0/>
- <https://raw.githubusercontent.com/ggozad/oterm/main/README.md>


## 安全说明

没有找到 oterm 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.local/share/oterm/config.json, ${XDG_DATA_HOME}/oterm/config.json, ${OTERM_DATA_DIR}/config.json
- macOS: ~/Library/Application Support/oterm/config.json, ${XDG_DATA_HOME}/oterm/config.json, ${OTERM_DATA_DIR}/config.json
- Windows: C:/Users/<USER>/AppData/Roaming/oterm/config.json

## Credential files

- Unix: ./.env, ${OTERM_DATA_DIR}/config.json
- Windows: ./.env, C:/Users/<USER>/AppData/Roaming/oterm/config.json
## 其他软件包管理器记录

- Nix - oterm: normalized package name match | nixpkgs package indexes: pkgs/by-name/ot/oterm/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/oterm.yml](https://github.com/mxcl/pkgdb/blob/main/combined/oterm.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
