Manual de instalación y uso de tgpt

1. ¿Qué es tgpt y para qué sirve?

tgpt es un cliente no oficial que permite interactuar con modelos tipo ChatGPT directamente desde la terminal, sin navegador y sin iniciar sesión en OpenAI.

Se usa mucho para:

• Resolver dudas técnicas rápidas
• Explicar comandos Linux
• Generar scripts
• Pedir ejemplos de código
• Documentar procesos
• Automatizar consultas desde scripts

No sustituye el razonamiento humano. Es un copiloto, no el piloto.

---

---

2. Instalación en Windows

Instalar Node.js

1. Descargar desde: https://nodejs.org
2. Instalar la versión LTS
3. Verificar desde PowerShell o CMD:

node -v
npm -v

Si aparecen versiones, todo va bien.

---

Instalar tgpt

En PowerShell o CMD:

npm install -g tgpt

Comprobar instalación:

tgpt --help

---

Primer uso en Windows

Ejemplo simple:

tgpt "¿Qué es un firewall?"

Ejemplo técnico:

tgpt "Explícame el comando netstat en Windows con ejemplos"

---

3. Instalación en Linux (Ubuntu, Debian, Kali, Parrot…)

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

Comprobar:

tgpt --help

---

Primer uso en Linux

Ejemplo OSINT:

tgpt "¿Qué es OSINT y qué tipos de fuentes existen?"

Ejemplo Linux:

tgpt "Explícame el comando grep con ejemplos reales"

Ejemplo scripting:

tgpt "Hazme un script bash para comprobar si un host responde a ping"

---

4. Instalación en macOS

5.1 Instalar Homebrew (si no está instalado)

En Terminal:

brew install tgpt

---

Verificar:

tgpt --help

Ejemplo programación:

tgpt "Dame un ejemplo sencillo de una API REST"

Ejemplo sistemas:

tgpt "Diferencias entre TCP y UDP explicadas para principiantes"

---

5. Uso básico de tgpt

Consulta directa

tgpt "Explícame qué es un hash"

---

Respuestas más técnicas

tgpt "Explícame qué es SHA-256 con un ejemplo práctico"

---

Modo conversación

tgpt -c

Permite hacer varias preguntas seguidas manteniendo contexto.

---

Salida sin colores (útil para logs o scripts)

tgpt --no-color "Qué es un IDS"

---

6. Buenas prácticas

• No copiar y pegar sin entender
• Verificar comandos antes de ejecutarlos
• Usar tgpt como ayuda, no como sustituto del aprendizaje
• Contrastar respuestas técnicas
• Documentar qué pregunta se hizo y por qué

---

7. Ejemplos

Ejemplo 1 – Linux

tgpt "Explícame paso a paso cómo funciona chmod"

Ejemplo 2 – Ciberseguridad

tgpt "Diferencias entre IDS y IPS con ejemplos"

Ejemplo 3 – OSINT

tgpt "Herramientas OSINT que se pueden usar desde terminal"

Ejemplo 4 – Programación

tgpt "Ejemplo de conexión a MySQL en PHP usando PDO"

---

8. Problemas comunes

• command not found → tgpt no está en el PATH
• Permisos npm → usar sudo en Linux
• Node muy antiguo → actualizar Node.js
• Respuestas erróneas → recordar que la IA puede equivocarse

---

Opciones y flags con ejemplos reales

Uso básico (sin flags)

tgpt "¿Qué es un IDS?"

Esto lanza una consulta directa y devuelve una respuesta estándar, con colores y formato amigable.

Es el modo “háblame como a un humano”.

---

-m → Elegir modelo (cuando está disponible)

El flag -m permite indicar el modelo que se quiere usar.
No siempre todos los modelos están activos, pero el concepto es clave didácticamente.

tgpt -m gpt-3.5-turbo "Explícame qué es OSINT"

Ejemplo técnico:

tgpt -m gpt-3.5-turbo "Dame un ejemplo de escaneo pasivo"

Prueba a comparar la misma pregunta con y sin -m y analizar diferencias de detalle, precisión o estilo.

---

-s → Modo shell / respuesta corta y directa

Este flag es oro para Linux.

-s (shell mode) intenta responder como si fuera una ayuda de terminal: más conciso, menos charla.

tgpt -s "comando para listar puertos abiertos en linux"

Salida típica: comandos directos, sin narrativa larga.

Ejemplo muy útil:

tgpt -s "como ver mi ip publica en linux"

---

-c → Modo conversación (contexto persistente)

Activa un modo interactivo.
tgpt recuerda lo que se ha dicho en esa sesión.

tgpt -c

Luego:

¿qué es nmap?
¿y en qué se diferencia de masscan?
ponme un ejemplo práctico

Esto es perfecto para:

• razonamiento progresivo
• tutoría guiada
• simulación de mentor técnico

El contexto se pierde al salir del programa.

---

--no-color → Sin colores (scripts, logs, redirecciones)

Cuando la salida se va a:

• un archivo
• un pipe
• un script bash

Los colores estorban.

tgpt --no-color "qué es un hash" > hash.txt

O encadenado:

tgpt --no-color -s "comando para ver procesos" | less

---

-q → Modo silencioso (solo respuesta)

El flag -q elimina encabezados y texto adicional.

tgpt -q "comando para ver usuarios conectados"

Muy útil cuando:

• quieres solo la respuesta
• estás comparando resultados
• lo usas como apoyo rápido

---

Combinando flags (aquí está la magia)

Ejemplo 1 – Linux puro

tgpt -s -q "ver uso de disco en linux"

Respuesta directa, corta, sin ruido.

---

Ejemplo 2 – OSINT

tgpt -s "herramientas osint que funcionen desde terminal"

---

Ejemplo 3 – Para scripting

tgpt --no-color -s "script bash para comprobar si un host responde a ping"

---

Ejemplo 4 – Clase de ciberseguridad

tgpt -c -s

Y dentro:

que es un firewall
diferencia entre firewall y waf
ejemplo en entorno real

---

Ver todas las opciones disponibles

Siempre recordar a los alumnos:

tgpt --help

Esto refuerza un hábito clave: leer la ayuda antes de preguntar.

---

Ejercicios

1. Ejecuta la misma pregunta de 3 formas:
   • sin flags
   • con -s
   • con -s -q
2. Pregunta:
   • ¿Cuál es más útil para terminal?
   • ¿Cuál para aprender?
   • ¿Cuál para automatizar?

Ejemplo de pregunta base:

"comando para ver conexiones activas en linux"

Chuleta rápida de tgpt

---

tgpt no es ChatGPT, es una interfaz.
Lo interesante no es la IA, sino cómo la integras en tu flujo de trabajo Linux:

---