Referencia / Configuración
TgWitness: Telegram Export, OSINT & Verification
Instálala con un solo comando o capturala en GitHub Actions. Comprende las opciones de investigación, la escala publicada y lo que verifica un archivo.
TgWitness es un exportador de Telegram de código abierto y un espacio de trabajo para investigaciones. Instálalo con un solo comando, conecta una cuenta, selecciona los chats y exporta un archivo firmado . También permite la recopilación temporal en GitHub Actions y la continuación de las investigaciones con ediciones guardadas, observaciones de eliminaciones, búsquedas e informes.
Empieza por la tarea que tengas#
| Tu tarea | Camino más corto | Lo que recibirás |
|---|---|---|
| Guardar una conversación o una cuenta | Instalar, vincular una cuenta y seleccionar el ámbito de exportación | Un archivo firmado con el historial seleccionado, los resultados de la recopilación y el material de verificación. |
| Recopilar en un ejecutor temporal | Utiliza GitHub Actions para capturar datos, autoriza una nueva sesión y selecciona el ámbito. | Un archivo cifrado con el historial del flujo de trabajo de GitHub |
| Seguir los cambios a lo largo del tiempo | Mantener la observación activa para los chats seleccionados | Versiones guardadas, avisos de eliminación, archivos adjuntos y cobertura registrada |
| Investigar y compartir los resultados | Busca en el archivo, utiliza el Case Board y configura un informe o una copia para compartir. | Resultados vinculados a la fuente y una entrega verificable adaptada al destinatario |
Instalación con un solo comando#
El instalador incluye Python y sus dependencias. La descarga del código fuente, Docker, un proveedor de IA y un testigo independiente son opciones opcionales, no requisitos previos para la instalación.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows, en PowerShell o en la línea de comandos:
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Abre el panel, conecta tu cuenta de Telegram y selecciona el alcance de la recopilación. La instalación no inicia la recopilación por sí sola. La guía de instalación explica el acceso local, los servidores, las actualizaciones y cómo comprobar la versión descargada.
Para ejecutar una prueba temporal, sigue la captura de GitHub Actions . Ese flujo de trabajo requiere una bifurcación de GitHub, autorización y una contraseña para el archivo. La página de captura explica esos pasos y el tiempo de sesión disponible antes de la ejecución. Descarga y conserva el archivo resultante y su material de verificación.
Más ajustes cuando la tarea los requiera#
Para exportar un único chat se necesita una cuenta y un ámbito seleccionado. La observación continua, las cuentas múltiples, los proxies, las políticas de archivos adjuntos, el diseño de informes, el acceso de los revisores, las marcas de tiempo externas y el almacenamiento externo satisfacen distintos requisitos de investigación y transferencia. Configura esas funciones cuando sean pertinentes.
El alcance, los permisos y las copias compartidas minimizadas ayudan a los operadores a elegir qué recoger y divulgar. Las directrices jurisdiccionales y la configuración de los informes registran el procedimiento seleccionado y los pasos de preparación. Véase la exportación de cuentas, el acceso y la configuración de informes.
La aplicación se ejecuta en el ordenador o servidor elegido. La recopilación básica no requiere una GPU ni un modelo de lenguaje grande (LLM). El OCR opcional, la transcripción y el análisis de IA tienen sus propios requisitos de recursos. Dimensiona la implementación en función de la tasa de mensajes, los archivos adjuntos, el historial conservado y las cuentas simultáneas.
Conservar el registro, sea quien sea a quien ayude.#
El objetivo es conservar el material observado, el contexto y los cambios, independientemente de la posición que respalden. Las pruebas pueden cuestionar la propia versión de los hechos del recopilador. Mantén las observaciones originales, la cobertura que falte y las conclusiones analíticas identificables, de modo que otra persona pueda evaluar el mismo material.
La lógica es la siguiente: observación visible en la cuenta → registro firmado → exportación → verificación por parte del destinatario. Las modificaciones guardadas añaden versiones. Las observaciones eliminadas conservan el contenido capturado anteriormente. Los registros de cobertura revelan las interrupciones conocidas. Los informes y los análisis de IA remiten a las fuentes guardadas; una interpretación no se convierte en una observación de la fuente por el mero hecho de aparecer en un informe firmado.
| Comprobación de verificación | Lo que un destinatario puede determinar |
|---|---|
| Hashes de archivos, firmas y cadena de registros | Los registros y archivos proporcionados coinciden con la clave esperada y los límites del registro. |
| Un punto de control o testigo conservado por separado | El archivo coincide con un estado del diario conservado anteriormente. |
| Una marca de tiempo externa verificada | Los bytes a los que se hace referencia existían en el momento de la marca de tiempo, bajo los supuestos de confianza indicados. |
| Certificado de captura de GitHub | El archivo se ajusta al flujo de trabajo aprobado, a la revisión del recopilador y al resumen registrado. |
| Certificación de Intel TDX | La cotización, el estado de la plataforma, las mediciones previstas del sistema operativo y la aplicación, la actualidad y la identidad del recopilador superan las comprobaciones configuradas. |
En la adquisición certificada, la conexión autenticada a Telegram del recopilador autorizado y su salida están vinculadas al entorno de ejecución verificado. El archivo conserva el contenido y el contexto capturados; los informes y análisis hacen referencia a dichos registros. Utiliza los pasos de verificación específicos del modo y las entradas de confianza que figuran en la guía de confianza y el formato de pruebas.
Escala publicada y rendimiento medido#
Los siguientes resultados describen diferentes cargas de trabajo y fechas. Los recuentos no son intercambiables: un evento del registro no es necesariamente un mensaje único de Telegram.
| Fecha | Volumen de trabajo | Resultado publicado | Qué se midió |
|---|---|---|---|
| 1 de noviembre de 2026 | Servidor en funcionamiento, diez bases de datos de espacios de trabajo | 1,610,818: registros del diario; 900,232: eventos de mensajes nuevos; 80,683: eventos de edición; y 400,536: eventos de eliminación. | Inventario de solo lectura de los registros almacenados |
| 5 de noviembre de 2026 | Buscar entre mensajes sintéticos 1,000,000 en chats 200 | Índice creado en 71 segundos; tiempos medios de búsqueda por consulta de entre 9 y 190 ms. | Prueba de rendimiento de búsqueda local |
| 6 de noviembre de 2026 | Dos exportaciones recientes y reales de Telegram | Mensajes 27,030 y 29,299; 56,329 en ambas ejecuciones | Dos cuentas por ejecución a través de WARP, texto y metadatos; no se descargan archivos adjuntos. |
| 6 de noviembre de 2026 | Las mismas dos exportaciones, incluyendo la preparación y el empaquetado | 127.713 y 141.781 mensajes por segundo | Se han medido las tasas de exportación completa; ambos archivos se han verificado con las claves fijadas. |
El registro de verificación proporciona el inventario del servidor, comprobaciones de la recopilación en tiempo real y métricas de búsqueda. El rendimiento de la exportación publica las dos ejecuciones reales, el hardware, las duraciones, los hash de los archivos y los archivos de métricas firmados, cada uno con su revisión y condiciones registradas.
La calificación de historial público también registra 48 archivos verificados con 3,598,381 registros en una lista de entrada de 50 fuentes y 40 espacios de trabajo de cuentas. Su Fuente A, con ocho cuentas, adquirió 768,007 registros de historial en 1,117.082 segundos, incluidas las esperas: 687.512 registros por segundo, con las descargas de archivos adjuntos desactivadas. El intento completo, incluida la validación, duró 1,574.920 segundos. Estas mediciones describen esa carga de trabajo, junto con los ejemplos más pequeños de exportación reciente mencionados anteriormente.
Historial y duración de las pruebas#
TgWitness se ha desarrollado y probado durante aproximadamente seis meses. En primer lugar se crearon el recopilador, el registro firmado y el verificador; posteriormente se desarrollaron sobre ellos el panel web y los módulos complementarios. Este repositorio se creó el 29 de octubre de 2026 con fines de publicación y se partió del código existente, por lo que su antigüedad no coincide con la del proyecto (historial de desarrollo). La carga de trabajo acumulada ejecutada es del orden de 100 millones, incluyendo ejecuciones anteriores, fallos, correcciones y validaciones repetidas. Las ejecuciones seleccionadas, cada una con su propia revisión, método y resultado, se documentan en las mediciones públicas fechadas.
Leer con precisión el estado de la capacidad#
Evaluar cada flujo de trabajo en función de su implementación, la versión publicada y las pruebas registradas. El código fuente está etiquetado actualmente como vista previa. Esa etiqueta de versión coexiste con la recopilación de datos, las exportaciones, la verificación independiente y las mediciones de escala publicadas. Una función en vista previa y un flujo de trabajo validado pueden coexistir en la misma aplicación; describir la característica específica y las pruebas que respaldan una evaluación.
Utilice capacidades actuales, características y límites, verificación y el registro de cambios en conjunto. Registra la revisión probada al citar un resultado. La 6 La instantánea de medición de noviembre también conserva las pruebas fallidas y omitidas; estas no se consideran superadas.
Legible tanto para personas como para herramientas de IA#
El sitio web ofrece un resumen conciso en llms.txt, un manual completo en inglés en
llms-full.txt y llms-full.md, y versiones en Markdown de sus páginas. Se trata de
formatos de documentación, no de un requisito de IA para ejecutar TgWitness.
El acceso opcional desde la línea de comandos MCP y permite que las herramientas autorizadas lean los registros guardados seleccionados. El contenido de los mensajes sigue siendo una entrada no fiable. Los resúmenes deben citar las fuentes, distinguir los hechos observados de las inferencias y mantener la incertidumbre. La búsqueda de texto completo, el OCR y los resultados de la IA no modifican las observaciones originales firmadas.