tgpt 🤖

tgpt is a Cross-platform Command-Line Interface (CLI) tool that allows you to use AI in your Terminal.

Currently available providers

Installation ⏬

Download for GNU/Linux 🐧 or MacOS 🍎

The default download location is /usr/local/bin, but you can change it in the command to use a different location. However, make sure the location is added to your PATH environment variable for easy accessibility.

You can download it with the following command:

curl -sSL https://raw.githubusercontent.com/aandrew-me/tgpt/main/install | bash -s /usr/local/bin

If you are using Arch Linux, you can install with pacman:

pacman -S tgpt

Install with Homebrew

brew install tgpt

FreeBSD 😈

To install the port:

cd /usr/ports/www/tgpt/ && make install clean

To install the package, run one of these commands:

pkg install www/tgpt
pkg install tgpt

Install with Go

You need to add the Go install directory to your system's shell path.

go install github.com/aandrew-me/tgpt/v2@latest

Windows 🪟

• Installation Script

  Open Powershell, copy and paste the command and press Enter to install.

  irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex
  

  Uninstall with

  & ([scriptblock]::Create((irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1))) -Uninstall
  

• Scoop: Package installation with Scoop can be done using the following command:

  scoop install https://raw.githubusercontent.com/aandrew-me/tgpt/main/tgpt.json
  

• Chocolatey

  choco install tgpt
  

From Release

You can download the executable for your operating system, rename it to tgpt (or any other desired name), and then execute it by typing ./tgpt while in that directory. Alternatively, you can add it to your PATH environmental variable and then execute it by simply typing tgpt.

Updating ⬆️

If you installed the program with the installation script (GNU/Linux, macOS, or Windows), you may update it with:

tgpt -u

(On GNU/Linux and macOS, it may require admin privileges depending on the install location.)

If you installed using a package manager (Homebrew, Pacman, Scoop, Chocolatey, Go), please update using your package manager's update command (e.g. brew upgrade tgpt, pacman -Syu tgpt, scoop update tgpt, choco upgrade tgpt, or go install github.com/aandrew-me/tgpt/v2@latest).

Usage

Proxy

Support:

1. Environment variable

http_proxy or HTTP_PROXY with following available formats:

• Http Proxy [ http://ip:port ]
• Http Auth [ http://user:pass@ip:port ]
• Socks5 Proxy [ socks5://ip:port ]
• Socks5 Auth [ socks5://user:pass@ip:port ]

2. Configuration file

Supported file locations:

• ./proxy.txt (in the same directory from where you are executing)
• ~/.config/tgpt/proxy.txt

Example:

http://127.0.0.1:8080

Uninstalling

If you installed with the install script, you can execute the following command to remove the tgpt executable

sudo rm $(which tgpt)

Configuration file is usually located in ~/.config/tgpt on GNU/Linux Systems and in "Library/Application Support/tgpt" on MacOS