tgpt

在终端里免费畅聊各种 AI 模型，无需切换窗口

tgpt 是一个用 Go 编写的终端 AI 聊天工具，让你在命令行里就能免费使用多种 AI 模型。它解决了开发者不想离开终端、或不想为 AI 服务付费的问题，通过统一的命令行界面，接入包括 GPT、Llama、Mixtral 等在内的多个免费 AI 提供方。核心能力包括：支持多模型切换、流式输出、对话历史保存、以及简单的配置管理。它轻量、跨平台（Windows/macOS/Linux），安装简单，适合脚本化调用和快速获取 AI 回答。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3264

维护状态活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队aandrew-me

所属国家

官网地址

GitHubhttps://github.com/aandrew-me/tgpt

定价模式free

价格说明开源免费，终端内使用，无付费版本。

访问状态

是否开源是

开源协议GPL-3.0

主要语言Go

技术栈/模型ai,chatbot,chatgpt,cli,go,golang,gpt4,linux,llama,macos,mixtral,terminal,windows

GitHub 星标★ 3264

30天Star增速

HF 下载量

上线时间2023-04-17 00:00:00

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

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

环境要求

Linux/macOS 使用安装脚本需要 curl 可用
Windows 需要使用 PowerShell 执行安装命令
用 Go 方式安装需先安装 Go，并把 Go 安装目录加入系统 shell PATH
若网络受限，需要自备可用 HTTP 代理地址

安装与启动步骤

1脚本安装（Linux/macOS）

默认装到 /usr/local/bin，可把路径换成其他目录，但要确保该目录已在 PATH 中。
```
curl -sSL https://raw.githubusercontent.com/aandrew-me/tgpt/main/install | bash -s /usr/local/bin
```
2Homebrew 安装

macOS 或已装 Homebrew 的 Linux 用户可直接用 brew 安装，无需手动处理路径。
```
brew install tgpt
```
3Arch Linux 安装

Arch 用户通过 pacman 从官方仓库安装。
```
pacman -S tgpt
```
4Go 方式安装

适合已配置好 Go 环境的用户，需先把 Go 安装目录加入 shell PATH 才能直接调用。
```
go install github.com/aandrew-me/tgpt/v2@latest
```
5Windows 安装

打开 PowerShell，粘贴命令后回车，脚本会自动下载并安装。
```
irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex
```
6FreeBSD 安装

可通过 port 编译安装，或直接用 pkg 安装预编译包。
```
pkg install tgpt
```
7配置代理（可选）

网络不通时，在 ~/.config/tgpt/proxy.txt 或当前目录的 ./proxy.txt 写入代理地址。

关键配置

配置项	必填	说明	示例
`~/.config/tgpt/proxy.txt`	否	写入 HTTP 代理地址，供 tgpt 访问 AI 服务时使用	`http://127.0.0.1:8080`
`./proxy.txt`	否	放在执行命令的当前目录下，优先级同样被支持	`http://127.0.0.1:8080`

如何确认成功

安装后在终端输入 tgpt 并回车，能正常返回 AI 回答即表示可用。

常见问题

Q：安装脚本默认装到哪里？能改吗？

A：默认下载到 /usr/local/bin，可在命令末尾把该路径换成别的目录，但要保证该目录已加入 PATH 才能直接运行 tgpt。

Q：Windows 上怎么安装？

A：打开 PowerShell，粘贴 irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex 并回车即可。

Q：用 go install 安装后提示找不到命令怎么办？

A：需要先把 Go 的安装目录（bin）加入系统 shell 的 PATH，再重新打开终端执行。

Q：在公司网络里用不了怎么办？

A：tgpt 支持代理配置文件，把形如 http://127.0.0.1:8080 的代理地址写入 proxy.txt 后重试。

注意事项

代理配置文件支持两处位置：执行目录下的 ./proxy.txt 和 ~/.config/tgpt/proxy.txt。
用安装脚本安装的 tgpt，可用 sudo rm $(which tgpt) 卸载。
配置目录在 Linux 上通常是 ~/.config/tgpt，在 macOS 上是 Library/Application Support/tgpt。
README 未给出端口、密钥等参数，tgpt 无需 API Key 即可使用提供的免费提供方。

核心亮点

免费接入多个 AI 模型，无需 API key 即可使用
纯命令行交互，轻量快速，适合开发者日常使用
支持流式输出和对话历史，体验流畅

不足之处

功能相对简单，缺少插件或扩展机制
文档/社区待观察

适用场景

开发者在终端中快速查询技术问题或生成代码片段
在 SSH 或无图形界面的服务器环境中使用 AI 助手
作为脚本工具，批量调用 AI 生成文本或处理数据

替代项目

shell-gpt、aichat、mods

项目介绍

tgpt 是对话助手领域的开源项目，由 aandrew-me 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,264）位列前 30%，在对话助手分类的 905 个项目里位列前 9%。

近 45 天，它的 GitHub 星标从 3,230 增加到 3,264，净增 34。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源免费，终端内使用，无付费版本。

它主要面向的使用场景是：开发者在终端中快速查询技术问题或生成代码片段。同类可对比的替代方案包括 shell-gpt、aichat、mods。

上一篇：AChat

下一篇：builderbot