tlm

在终端里用本地大模型，随时提问，数据不出本机。

tlm 是一个基于 Ollama 的本地命令行 AI 助手，用 Go 语言编写。它解决了在终端环境中直接使用本地大模型的需求，无需离开命令行即可获得 AI 辅助。核心能力包括：与本地 Ollama 服务无缝集成，支持多种模型切换；提供交互式聊天模式，方便连续对话；支持管道输入，可对文本流进行实时处理；具备上下文记忆功能，能记住之前的对话内容。它让开发者能在终端中快速完成代码解释、命令生成、文本摘要等任务，同时保障数据隐私，所有处理都在本地完成。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1486

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队yusufcanb

所属国家

官网地址

GitHubhttps://github.com/yusufcanb/tlm

定价模式free

价格说明开源项目，本地部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型bash,deepseek-r1,llama3,llm,phi4,powershell,qwen2-5,zsh

GitHub 星标★ 1486

30天Star增速

HF 下载量

上线时间2024-02-14 00:00:00

最近更新2026-09-17 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Go 1.22 或更高版本（使用 Go Install 方式时）
本地已安装并运行 Ollama 服务
操作系统为 macOS、Linux 或 Windows
终端 shell 为 PowerShell、Bash 或 Zsh 之一

安装与启动步骤

1安装 tlm

README 推荐直接用安装脚本，脚本会自动识别平台架构；若本机已有 Go 1.22+，可用如下 Go 安装命令。安装脚本的具体命令 README 未给出，请到仓库 Installation 一节查看。
```
go install github.com/yusufcanb/tlm@1.2
```
2验证安装

README 明确说明用该命令检查安装是否成功，会打印 tlm 的帮助信息与可用子命令列表。
```
tlm
```
3配置模型与 shell

用 config 子命令配置语言模型、风格和 shell。tlm 会自动识别 PowerShell、Bash、Zsh，也可在此手动调整。
```
tlm config
```
4生成命令建议

用 suggest（简写 s）把自然语言需求转成命令，可用 --model 覆盖默认模型，用 --style 选择风格。
```
tlm suggest "count lines of a file"
```
5解释一条命令

用 explain（简写 e）解释已有命令的含义，可临时指定其他模型，例如改用 llama3.2:1b。
```
tlm explain "tar -xzvf archive.tar.gz"
```
6带上下文提问

用 ask 提问（beta），通过 --context 指定目录、--include 指定文件模式，实现免配置的 RAG 检索增强问答。
```
tlm ask --context . --include *.md "what does this project do"
```

关键配置

配置项	必填	说明	示例
`--model`	否	临时覆盖当前使用的 Ollama 模型	`qwen2.5-coder:1.5b`
`--style`	否	选择输出风格，如 stable、balanced	`stable`
`--context`	否	ask 命令的上下文目录，用于检索增强	`.`
`--include`	否	ask 命令中参与上下文的文件通配模式	`*.md`

如何确认成功

在终端执行 tlm，能正常打印 NAME、USAGE、COMMANDS 等帮助信息并列出子命令，即安装成功。

常见问题

Q：需要 API Key 或联网吗？

A：不需要。tlm 无需任何订阅或 API Key，也不需要互联网连接，模型与推理全部在本地完成，数据不出本机。

Q：支持哪些操作系统和 shell？

A：支持 macOS、Linux 和 Windows，并能自动检测 PowerShell、Bash、Zsh 三种 shell。

Q：怎么换用别的模型？

A：可用 tlm config 修改默认模型，也可在单条命令上用 --model 覆盖，例如 --model=llama3.2:1b，模型取自 Ollama 模型库。

Q：如何卸载 tlm？

A：Linux/macOS 执行 rm /usr/local/bin/tlm 与 rm ~/.tlm.yml；Windows 删除 AppDataLocalPrograms lm 目录和 $HOME.tlm.yml。

注意事项

tlm 依赖本地 Ollama 提供模型服务，README 未给出 Ollama 的安装与拉取模型命令，使用前请先自行准备本地 Ollama 环境。
README 推荐使用安装脚本方式安装，但未给出脚本具体命令，请到仓库 Installation Script 一节获取。
Go Install 方式要求系统已安装 Go 1.22 或更高版本。
卸载时建议一并删除 ~/.tlm.yml，以清除模型、风格与 shell 配置。

核心亮点

与 Ollama 深度集成，一条命令即可调用本地模型，无需额外配置
支持管道输入，能直接处理命令输出或文件内容，自动化工作流友好
交互式聊天体验流畅，支持多轮对话，上下文保持自然

不足之处

依赖 Ollama 环境，需先安装并配置 Ollama 才能使用
功能相对基础，缺少插件扩展机制，高级定制能力有限

适用场景

开发者写代码时快速查询语法或生成代码片段
系统管理员在终端中解释日志或命令输出
隐私敏感场景下使用本地模型进行文本处理

替代项目

aichat、shell-gpt、mods

项目介绍

tlm 是编程开发领域的开源项目，由 yusufcanb 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,486）位列前 30%，在编程开发分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-17。本地部署，完全免费。

它主要面向的使用场景是：开发者写代码时快速查询语法或生成代码片段。同类可对比的替代方案包括 aichat、shell-gpt、mods。

上一篇：zerostack

下一篇：llama.vscode

tlm