DeepRat commited on
Commit
940ea4a
·
verified ·
1 Parent(s): 303445f

Rename README.md to README_es.md

Browse files
Files changed (2) hide show
  1. README.md +0 -132
  2. README_es.md +154 -0
README.md DELETED
@@ -1,132 +0,0 @@
1
- ---
2
- title: TrueEye Reports
3
- emoji: 🧿
4
- colorFrom: purple
5
- colorTo: purple
6
- sdk: docker
7
- pinned: false
8
- license: mit
9
- thumbnail: >-
10
- https://cdn-uploads.huggingface.co/production/uploads/683866c9aa7db732a49d525d/a1tcXbQwNIxmPOaXWdHwQ.png
11
- ---
12
- # 🧿 TrueEye — Intelligent Media Literacy System
13
-
14
- **TrueEye** es una herramienta de inteligencia artificial diseñada para analizar artículos de noticias y contenido web, con el objetivo de detectar **sesgos narrativos**, identificar la **audiencia objetivo**, y revelar **intencionalidades ocultas** o estructuras de manipulación simbólica.
15
-
16
- > “TrueEye no sólo detecta fake news, sino también para quiénes fueron escritas y por qué.”
17
-
18
- ---
19
-
20
- ## 🚀 Demo
21
-
22
- * 🎯 [Abrir TrueEye en Hugging Face Spaces](https://huggingface.co/spaces/DeepRat/TrueEye_Reports)
23
- * 🌐 [Sitio oficial del proyecto](https://trueeye.deeprat.tech)
24
-
25
- ---
26
-
27
- ## 🧩 ¿Qué hace TrueEye?
28
-
29
- Cuando ingresás una URL, TrueEye realiza tres análisis consecutivos:
30
-
31
- 1. **📊 Sesgo y Matices**
32
-
33
- * Detecta la polaridad narrativa (positiva, negativa o neutral)
34
- * Identifica matices como polarización, miedo, desconfianza
35
- * Resume el contenido y señala afirmaciones engañosas o débiles
36
-
37
- 2. **🎯 Segmentación de Audiencia**
38
-
39
- * Infiere perfil demográfico y psicográfico del lector objetivo
40
- * Analiza valores, creencias, emociones y sesgos explotados
41
- * Detecta timing, contexto de consumo y estrategias de targeting
42
-
43
- 3. **⚠️ Intencionalidad y Peligrosidad**
44
-
45
- * Evalúa la presencia de manipulación o violencia simbólica
46
- * Identifica agendas políticas, actores beneficiados y omisiones críticas
47
- * Asigna nivel de sofisticación y daño potencial
48
-
49
- 🔍 Además, el informe incluye enlaces a fuentes externas confiables para fact-checking.
50
-
51
- ---
52
-
53
- ## ⚙️ Arquitectura
54
-
55
- * **Frontend**: HTML + TailwindCSS + JS
56
- * **Backend**: FastAPI (Python) + Requests
57
- * **Orquestación IA**: LangFlow + agentes Claude (Opus / Sonnet)
58
- * **Despliegue**: Docker en Hugging Face Spaces
59
-
60
- ---
61
-
62
- ## 💻 Perfil técnico del autor
63
-
64
- Este proyecto fue desarrollado por **Gonzalo Romero**, estudiante de Ingeniería en Sistemas, **Ingeniero en Inteligencia Artificial** certificado por IBM, y **practicante profesional de Ingeniería de Software**, con foco en aplicaciones IA explicables y de impacto social.
65
-
66
- ---
67
-
68
- ## 📁 Estructura del repositorio
69
-
70
- ```
71
- 📦 trueeye
72
- ├── static/
73
- │ ├── index.html # Interfaz visual
74
- │ └── te.png # Logo del proyecto
75
- ├── main.py # Backend FastAPI que conecta al flujo LangFlow
76
- ├── requirements.txt # Dependencias del backend
77
- ├── Dockerfile # Imagen para Hugging Face Spaces
78
- ├── TrueEyeBeta.json # Flujo LangFlow con agentes y lógica IA
79
- ```
80
-
81
- ---
82
-
83
-
84
- ## 📌 Roadmap
85
-
86
- | Versión | Estado | Descripción |
87
- | -------- | ------------- | ------------------------------------------------------ |
88
- | ✅ v1.0 | En producción | Análisis textual completo con IA explicativa |
89
- | 🔄 v2.0 | En diseño | “TrueEye Chat”: interacción conversacional con memoria |
90
- | 🖼️ v3.0 | Planificada | Análisis multimodal: texto + imágenes/audio/video |
91
- | 🧪 v4.0 | Planificada | Detección de deepfakes y contenido sintético |
92
-
93
- ---
94
-
95
- ## 👨‍💻 Cómo ejecutarlo localmente
96
-
97
- ```bash
98
- # Clonar el proyecto
99
- git clone https://github.com/DeepRat/trueeye.git
100
- cd trueeye
101
-
102
- # Instalar dependencias
103
- pip install -r requirements.txt
104
-
105
- # Iniciar servidor backend
106
- uvicorn main:app --reload
107
- ```
108
-
109
- Luego abrí `static/index.html` en tu navegador. El frontend interactúa con `localhost:8000/analyze`.
110
-
111
- ---
112
-
113
- ## 📚 Tecnologías utilizadas
114
-
115
- * `FastAPI` · `LangFlow` · `Claude Opus/Sonnet` · `Docker`
116
- * `TailwindCSS` · `JavaScript` · `Marked.js`
117
-
118
- ---
119
-
120
- ## ✍️ Autor
121
-
122
- **Gonzalo Romero (HermesIA)**
123
- AI Engineer · Software Engineer · Systems Engineering Student
124
- 🔗 [deeprat.tech](https://deeprat.tech) · [GitHub](https://github.com/DeepRat) · [Hugging Face](https://huggingface.co/DeepRat) · [LinkedIn](https://www.linkedin.com/in/gonzaloromerodeeprat) · [Medium](https://medium.com/@gonzaloromerodeeprat)
125
-
126
- ---
127
-
128
- ## 🧠 Licencia
129
-
130
- MIT License — uso libre y adaptaciones permitidas. El crédito es bienvenido.
131
-
132
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
README_es.md ADDED
@@ -0,0 +1,154 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: TrueEye Reports
3
+ emoji: 🧿
4
+ colorFrom: purple
5
+ colorTo: purple
6
+ sdk: docker
7
+ pinned: false
8
+ license: mit
9
+ thumbnail: >-
10
+ https://cdn-uploads.huggingface.co/production/uploads/683866c9aa7db732a49d525d/a1tcXbQwNIxmPOaXWdHwQ.png
11
+ ---
12
+
13
+ ---
14
+
15
+ # 🧿 TrueEye — Sistema Inteligente de Alfabetización Mediática
16
+
17
+ **TrueEye** es una herramienta de inteligencia artificial diseñada para analizar artículos de noticias y contenido web, con el objetivo de detectar sesgos narrativos, identificar la audiencia objetivo y revelar intencionalidades ocultas o estructuras de manipulación simbólica.
18
+ En otras palabras, **no solo detecta noticias falsas**, sino que también examina **para quiénes fue escrito un contenido y con qué propósito**.
19
+ El sistema produce un informe detallado que ayuda a la alfabetización mediática, señalando indicios sutiles presentes en el texto.
20
+
21
+ ---
22
+
23
+ ## 🚀 Demo
24
+
25
+ * 🌐 [Probar TrueEye en Hugging Face Spaces](https://huggingface.co/spaces/DeepRat/TrueEye_Reports)
26
+ * 🖥️ [Sitio oficial del proyecto](https://trueeye.deeprat.tech)
27
+
28
+ > Nota: La demo en Hugging Face requiere acceso a internet y puede necesitar iniciar sesión.
29
+
30
+ ---
31
+
32
+ ## 🧩 ¿Qué hace TrueEye?
33
+
34
+ Al ingresar una URL de un artículo de noticias, **TrueEye** realiza **tres análisis consecutivos**:
35
+
36
+ ### 📊 Sesgos y Matices
37
+
38
+ * Detecta la polaridad narrativa (positiva, negativa o neutral).
39
+ * Identifica estrategias retóricas (miedo, manipulación, ironía, etc.).
40
+ * Resume el artículo y marca afirmaciones cuestionables.
41
+
42
+ ### 🎯 Segmentación de Audiencia
43
+
44
+ * Infiere el perfil demográfico y emocional del lector objetivo.
45
+ * Detecta valores explotados, sesgos reafirmados y momento de consumo esperado.
46
+
47
+ ### ⚠️ Intencionalidad y Peligrosidad
48
+
49
+ * Evalúa manipulación simbólica, agendas ocultas y beneficiarios.
50
+ * Estima nivel de sofisticación narrativa y riesgo de impacto social.
51
+
52
+ > Cada informe incluye enlaces a fuentes confiables para verificación.
53
+
54
+ ---
55
+
56
+ ## ⚙️ Arquitectura del Proyecto
57
+
58
+ **TrueEye** consta de tres capas principales:
59
+
60
+ * 🧱 **Frontend**: Web estática en HTML + TailwindCSS + JS (`static/index.html`).
61
+ * 🧠 **Backend**: API REST en Python (`main.py`) con FastAPI.
62
+ * 🔁 **Orquestación IA**: Flujo de LangFlow (`TrueEyeBeta.json`) con agentes Claude (Opus / Sonnet).
63
+
64
+ > El análisis lo realizan modelos de lenguaje ejecutados vía LangFlow + APIs externas.
65
+
66
+ ---
67
+
68
+ ## 📁 Estructura del Repositorio
69
+
70
+ ```
71
+ TrueEye_v1/
72
+ ├── static/
73
+ │ ├── index.html # Interfaz frontend
74
+ │ └── te.png # Logo del proyecto
75
+ ├── main.py # Backend FastAPI
76
+ ├── requirements.txt # Dependencias Python
77
+ ├── Dockerfile # Despliegue (HuggingFace)
78
+ ├── TrueEyeBeta.json # Flujo IA de LangFlow
79
+ ```
80
+
81
+ ---
82
+
83
+ ## 💻 Cómo Ejecutarlo Localmente
84
+
85
+ ### 🔧 Requisitos mínimos
86
+
87
+ * ✅ Python **3.10+**
88
+ * ✅ Acceso a internet (para conectarse con los modelos de IA)
89
+ * ✅ Clave API de **Claude** o modelo compatible
90
+ * ✅ LangFlow instalado (`pip install langflow`)
91
+
92
+ > 💡 No se requiere GPU ni hardware especializado. Todo el procesamiento se delega a los modelos externos.
93
+
94
+ ### 🧪 Pasos para correrlo:
95
+
96
+ ```bash
97
+ # 1. Clonar el repo
98
+ git clone https://github.com/DeepRatAI/TrueEye_v1.git
99
+ cd TrueEye_v1
100
+
101
+ # 2. Instalar dependencias del backend
102
+ pip install -r requirements.txt
103
+
104
+ # 3. Definir la URL del flujo LangFlow
105
+ export FLOW_API_URL="http://localhost:7860/predict" # Reemplazar según tu instancia
106
+
107
+ # 4. Lanzar el backend
108
+ uvicorn main:app --reload
109
+ ```
110
+
111
+ Luego, abrí el archivo `static/index.html` en tu navegador.
112
+ Introducí una URL, presioná "Analizar", y obtendrás el informe generado por IA en segundos.
113
+
114
+ ---
115
+
116
+ ## 📌 Roadmap
117
+
118
+ | Versión | Estado | Descripción |
119
+ | -------- | ------------- | ------------------------------------------------------------ |
120
+ | ✅ v1.0 | En producción | Análisis textual completo por URL con IA explicativa |
121
+ | 🔄 v2.0 | En diseño | TrueEye Chat: versión conversacional con memoria persistente |
122
+ | 🖼️ v3.0 | Planificada | Razonamiento multimodal sobre texto + imágenes/audio/video |
123
+ | 🧪 v4.0 | Planificada | Detección de deepfakes y contenido sintético |
124
+
125
+ ---
126
+
127
+ ## 📚 Tecnologías Utilizadas
128
+
129
+ * **FastAPI** — Backend API REST en Python.
130
+ * **LangFlow** — Orquestación de flujos LLM con agentes, memoria y lógica condicional.
131
+ * **Claude Opus / Sonnet** — Modelos de lenguaje vía API Anthropic.
132
+ * **TailwindCSS & JS** — Interfaz frontend simple y moderna.
133
+ * **Docker** — Para despliegue reproducible (Hugging Face Spaces).
134
+
135
+ ---
136
+
137
+ ## ✍️ Autor
138
+
139
+ **Gonzalo Romero (DeepRat)**
140
+ Ingeniero en IA, Software y Sistemas · Prompt Engineer · Full-stack Developer
141
+
142
+ 🔗 [Web](https://deeprat.tech) | [Hugging Face](https://huggingface.co/DeepRat) | [GitHub](https://github.com/DeepRatAI) | [LinkedIn](https://www.linkedin.com/in/deeprat) | [Medium](https://medium.com/@deeprat)
143
+
144
+ ---
145
+
146
+ ## 🧠 Licencia
147
+
148
+ Este proyecto está licenciado bajo **Creative Commons Attribution-NonCommercial 4.0 (CC BY-NC 4.0)**.
149
+ Podés copiar, modificar y distribuir el código, **siempre que menciones al autor (DeepRat)** y **no lo utilices con fines comerciales sin autorización previa**.
150
+
151
+ > Para usos comerciales o licencias extendidas, contactá a: info@deeprat.tech
152
+
153
+ ---
154
+