🧠 tgpt: Use um Chatbot de IA no Terminal, sem precisar de chaves de API

O tgpt é uma ferramenta de linha de comando (CLI) multiplataforma que permite o uso de um chatbot de Inteligência Artificial diretamente no terminal, sem exigir chaves de API — embora também ofereça suporte para quem deseja usar provedores com chave própria, como OpenAI ou Gemini.

Ideal para desenvolvedores, sysadmins e entusiastas da automação, o tgpt oferece uma experiência semelhante ao ChatGPT diretamente na linha de comando, com suporte a múltiplos provedores de IA e até mesmo geração de imagens via texto.

⚙️ Principais recursos

  • ✔️ Compatível com Linux, macOS, Windows, FreeBSD
  • ✔️ Suporte a múltiplos provedores de IA (com ou sem API key)
  • ✔️ Pode executar comandos shell (experimental)
  • ✔️ Geração de código e respostas técnicas
  • ✔️ Geração de imagens por texto com provedores como Arta e Pollinations
  • ✔️ Modo interativo e integração com proxies

🧠 Provedores disponíveis

  • phind (padrão) — Ótimo para desenvolvedores
  • openai — Requer API key, suporta todos os modelos oficiais
  • gemini — Precisa de API gratuita do Google
  • groq — Rápido, gratuito, suporta múltiplos modelos
  • isou — Gratuito, com busca via web
  • deepseek — Necessita API, com foco em raciocínio
  • koboldai — Focado em geração de histórias
  • ollama — Executa localmente modelos como LLaMA, Mistral
  • pollinations — Gratuito, ótimo para geração de texto e imagem

📦 Instalação

Instalação via script

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

O binário será instalado em /usr/local/bin. Certifique-se de que este caminho esteja no seu $PATH.

Outras formas de instalação

Arch Linux

pacman -S tgpt

FreeBSD

cd /usr/ports/www/tgpt/ && make install clean
# ou
pkg install tgpt

Go

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

Windows

  • Scoop:

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

  • Chocolatey:

    choco install tgpt

🧪 Exemplos de uso

tgpt "Explique o que é internet"
tgpt -m                            # Modo multi-linha interativo
tgpt -s "Como atualizar meu sistema?"
tgpt --provider openai --key sk-XXXX --model "gpt-4" "Explique o código abaixo"
tgpt --img "um gato em uma bicicleta"
tgpt --img --out ~/gato.jpg --width 256 --height 256 "gato estilo cyberpunk"

gato_estilo_cyberpunk_comando

gato_estilo_cyberpunk_resultado

🔧 Principais flags disponíveis

Flag / Opção Descrição
-s, --shell Gera e executa comandos shell (experimental)
-c, --code Gera código (experimental)
-i, --interactive Modo interativo padrão
-m, --multiline Modo interativo multi-linha
-img, --image Gera imagem via prompt de texto
--provider Define o provedor de IA
--key Define a chave de API (quando aplicável)
--model Escolhe o modelo (varia conforme provedor)
--temperature, --top_p Ajusta criatividade e variedade
--out, --height, --width Parâmetros para geração de imagem
-u Atualiza o tgpt para a versão mais recente
--log Salva conversas em arquivo
--help Mostra a ajuda completa

🎨 Provedores de geração de imagem

  • pollinations – Modelos como Turbo, Flux
  • arta – Vários estilos artísticos, como:
    • Realistic tattoo, Anime tattoo, Vincent Van Gogh, Surrealismo, Graffiti, Dreamshaper-xl, etc.
    • Suporte para proporções como 1:1, 16:9, 9:16, entre outras

🌐 Proxy

O tgpt suporta uso de proxy HTTP e SOCKS5 via:

  • Variáveis de ambiente: http_proxy, HTTP_PROXY
  • Arquivos de configuração:
    • ./proxy.txt
    • ~/.config/tgpt/proxy.txt

Exemplo de proxy:

http://127.0.0.1:8080

🧼 Desinstalação

Se instalado via script, basta executar:

sudo rm $(which tgpt)

📁 Arquivo de configuração

  • Linux: ~/.config/tgpt
  • macOS: ~/Library/Application Support/tgpt

🔄 Atualização

Se instalado via script, atualize com:

tgpt -u

Pode exigir permissões de administrador (sudo).

🔗 Links úteis