ggozad/oterm

the terminal client for LLMs

2,426

stars

860

commits

Python

primary language

Sep 2, 2026

updated

llm
llms
machine-learning
ollama
python
terminal

README

oterm

Tests codecov

The terminal client for Ollama, OpenAI, Anthropic, and any pydantic-ai-supported provider.

Splash

Install

uvx oterm

Full install methods, configuration, and usage: oterm Documentation.

What's new

  • Spoken responses. The new speak capability reads replies aloud through piper as they stream, in the GLaDOS voice. Run uvx "oterm[speak]", which needs Python 3.11 or newer. The base install is untouched and the capability appears only once the extra is present.
  • Multi-provider, via pydantic-ai (breaking). oterm is no longer Ollama-only — it drives any pydantic-ai-supported provider: OpenAI, Anthropic, Google (AI / Vertex), Groq, Mistral, Cohere, AWS Bedrock, DeepSeek, Cerebras, Grok, Hugging Face, OpenAI-compatible endpoints (vLLM, LM Studio, llama.cpp, OpenRouter, LiteLLM, …), and Ollama. Set the matching API key and the provider appears in the new-chat dropdown.
  • Refreshed chat UI. Borderless accent-driven layout, auto-growing prompt, inline [Image #N] attachment tokens, a collapsing thinking section, and a live token-usage footer in place of the spinner.
  • Faster streaming. Markdown is now updated as deltas arrive instead of being re-rendered on every token, so long responses don't slow the terminal as they grow.
  • MCP rewrite (breaking). The mcpServers config block adopts pydantic-ai's standard schema (compatible with Claude Desktop / Cursor). See docs/mcp for the full migration notes.

License

MIT License.

Contributors

ggozad

801 commits

robbyt

7 commits

yilmaz08

7 commits

liorm

5 commits

ggozad/oterm

the terminal client for LLMs

2,426

stars

860

commits

Python

primary language

Sep 2, 2026

updated

llm
llms
machine-learning
ollama
python
terminal

README

oterm

Tests codecov

The terminal client for Ollama, OpenAI, Anthropic, and any pydantic-ai-supported provider.

Splash

Install

uvx oterm

Full install methods, configuration, and usage: oterm Documentation.

What's new

  • Spoken responses. The new speak capability reads replies aloud through piper as they stream, in the GLaDOS voice. Run uvx "oterm[speak]", which needs Python 3.11 or newer. The base install is untouched and the capability appears only once the extra is present.
  • Multi-provider, via pydantic-ai (breaking). oterm is no longer Ollama-only — it drives any pydantic-ai-supported provider: OpenAI, Anthropic, Google (AI / Vertex), Groq, Mistral, Cohere, AWS Bedrock, DeepSeek, Cerebras, Grok, Hugging Face, OpenAI-compatible endpoints (vLLM, LM Studio, llama.cpp, OpenRouter, LiteLLM, …), and Ollama. Set the matching API key and the provider appears in the new-chat dropdown.
  • Refreshed chat UI. Borderless accent-driven layout, auto-growing prompt, inline [Image #N] attachment tokens, a collapsing thinking section, and a live token-usage footer in place of the spinner.
  • Faster streaming. Markdown is now updated as deltas arrive instead of being re-rendered on every token, so long responses don't slow the terminal as they grow.
  • MCP rewrite (breaking). The mcpServers config block adopts pydantic-ai's standard schema (compatible with Claude Desktop / Cursor). See docs/mcp for the full migration notes.

License

MIT License.

Contributors

ggozad

801 commits

robbyt

7 commits

yilmaz08

7 commits

liorm

5 commits

Languages

Python

99.6%