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é recopilar y divulgar. Las orientaciones sobre jurisdicción y la configuración de los informes respaldan esa decisión; la selección de un perfil no garantiza por sí misma el cumplimiento legal ni la admisibilidad. Véase exportación de cuentas, acceso y 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; una instalación sencilla no garantiza un consumo de memoria fijo para todas las cargas de trabajo.
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. |
Estas comprobaciones permiten verificar la integridad y la procedencia. No convierten el contenido de un mensaje en una afirmación verdadera ni reconstruyen mensajes eliminados que no se hayan visto . Utiliza una huella digital de la clave obtenida de forma independiente y los pasos de verificación descritos 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; no se trata de una prueba de rendimiento ni de una nueva verificación de cadena completa. |
| 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; no se trata de la entrega en tiempo real de Telegram. |
| 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, las comprobaciones de recopilación en tiempo real y las mediciones de búsqueda. Rendimiento de exportación publica las dos ejecuciones reales, el hardware, las duraciones, los hash de los archivos y los archivos de medición firmados. Estos establecen resultados para las revisiones y condiciones registradas, no una tasa universal ni un límite máximo de capacidad.
Historial y duración de las pruebas#
El responsable del proyecto informa de más de seis meses de pruebas a fecha de 6 de noviembre de 2026. Esto describe el historial de pruebas del proyecto. Las mediciones públicas fechadas anteriores documentan ejecuciones individuales; no constituyen una recopilación ininterrumpida de seis meses verificada de forma independiente. La antigüedad de los mensajes exportados también difiere del tiempo que lleva en funcionamiento el recopilador.
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.