MDFJ
/

neo2

@@ -1,169 +1,45 @@
-# NEO-1 / NEO-2 — mdfjbots
-> Chatbot conversacional de código abierto con base de conocimiento, búsqueda web con filtrado de licencias, API Roblox, calculadora y edición cerrada cifrada.
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
-[![Gradio](https://img.shields.io/badge/gradio-4.44%2B-orange)](https://gradio.app/)
-[![Node.js](https://img.shields.io/badge/node-18%2B-green)](https://nodejs.org/)
----
-## Descripción
-**NEO-1** es un chatbot basado en reglas con una base de conocimiento JSON, coincidencia de tokens con similitud ponderada y variación de respuestas para evitar repeticiones.
-**NEO-2** extiende NEO-1 con búsqueda web real (DuckDuckGo) que filtra automáticamente las fuentes por licencia, usando solo contenido bajo **CC BY**, **CC0** o dominio público. Las fuentes con licencias restrictivas (All Rights Reserved, CC BY-ND, CC BY-NC, etc.) son descartadas.
-Ambas ediciones incluyen integración con la API de Roblox, una calculadora matemática y una REST API (NeoAPI) para integración con bots externos.
 ---
-## Características
-### NEO-1 (base)
-- **Base de conocimiento JSON** — respuestas editables sin tocar código
-- **Tokenización con stopwords** — evita falsos positivos en palabras vacías del español
-- **Similitud ponderada** — encuentra la mejor coincidencia entre la pregunta y las respuestas conocidas
-- **Variación de respuestas** — reformula las respuestas para evitar repetirlas verbatim
-- **Streaming palabra por palabra** — efecto de escritura en tiempo real
-- **Calculadora integrada** — resuelve operaciones matemáticas (`2 + 2`, `raíz de 144`, etc.)
-- **API Roblox** — busca jugadores y juegos por nombre usando la API oficial
-### NEO-2 (+ búsqueda web)
-- **Búsqueda DuckDuckGo** — consultas reales a internet cuando la base de conocimiento no responde
-- **Filtrado de licencias** — solo usa fuentes bajo CC BY, CC0 o dominio público
-- **Resumen abstractivo** — genera prosa propia a partir de los resultados, no copia textualmente
-- **Caché de sesión** — evita búsquedas repetidas para la misma query (hasta 50 entradas)
-- **Reintentos automáticos** — reintenta hasta 2 veces con pausa ante fallos de red
-- **Errores tipificados** — distingue entre fallo de red, rate-limit y sin resultados
-### Edición cerrada
-- **Cifrado de respuestas** — `respuestas.dat` generado con XOR + zlib + base64
-- **Compilador incluido** — `compilar_respuestas.py` convierte `respuestas.json` a `.dat`
-- **Clave por variable de entorno** — `NEO_DATA_KEY` nunca aparece en el código
-### NeoAPI (REST)
-- Servidor Node.js/Express independiente en puerto 8080
-- Autenticación por API key con prefijo `neo1-`
-- Endpoints para consultar el chatbot desde servicios externos
-- Panel de administración de claves protegido por `NEO_ADMIN_SECRET`
 ---
-## Estructura del proyecto
-```
-/
-├── chat-app/
-│   ├── app.py                 # Aplicación Gradio principal (NEO-1 + NEO-2)
-│   ├── logica.py              # Motor de coincidencia y tokenización
-│   ├── buscador.py            # Búsqueda web con filtrado de licencias (NEO-2)
-│   ├── resumidor.py           # Resumen abstractivo de resultados web
-│   ├── matematicas.py         # Calculadora de operaciones matemáticas
-│   ├── roblox_api.py          # Cliente de la API pública de Roblox
-│   ├── neo_rest.py            # Servidor REST en puerto 5001
-│   ├── compilar_respuestas.py # Compilador de edición cerrada
-│   ├── respuestas.json        # Base de conocimiento (editable)
-│   ├── respuestas.dat         # Base de conocimiento cifrada (edición cerrada)
-│   └── requirements.txt
-│
-└── artifacts/
-    ├── api-server/            # NeoAPI — REST API en Node.js/TypeScript
-    └── neo1-chat/             # Frontend web (React + Vite)
-```
----
-## Instalación
-### Requisitos
-- Python 3.10+
-- Node.js 18+ y pnpm (para NeoAPI y frontend)
-### Chatbot (NEO-1 / NEO-2)
-```bash
-cd chat-app
-pip install -r requirements.txt
-```
-Variables de entorno opcionales:
-| Variable | Descripción |
-|---|---|
-| `NEO_DATA_KEY` | Clave de cifrado para edición cerrada |
-| `NEO_ADMIN_SECRET` | Contraseña de administración de NeoAPI |
-### Ejecutar
-```bash
-# Chatbot Gradio en puerto 5000 + REST en 5001
-PORT=5000 python app.py
-# NeoAPI (desde raíz del proyecto)
-pnpm --filter @workspace/api-server run dev
-```
----
-## Uso
-### Interfaz web (Gradio)
-Navega a `http://localhost:5000` — escribe cualquier pregunta en el chat.
-**Ejemplos de consultas:**
-- `¿Qué es una supernova?` → busca en base de conocimiento o internet
-- `cuánto es 15 * 7 + 3` → calculadora
-- `busca el jugador Builderman en Roblox` → API Roblox
-- `qué juegos de Roblox tienen más visitas` → API Roblox
-### NeoAPI (REST)
-```bash
-# Consultar el chatbot
-curl -X POST http://localhost:8080/api/chat \
-  -H "Authorization: Bearer neo1-<tu_api_key>" \
-  -H "Content-Type: application/json" \
-  -d '{"message": "Hola, ¿qué eres?"}'
-# Crear una API key (requiere NEO_ADMIN_SECRET)
-curl -X POST http://localhost:8080/api/keys \
-  -H "Authorization: Bearer <NEO_ADMIN_SECRET>" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "mi-servicio"}'
-```
-### Compilar edición cerrada
-```bash
-export NEO_DATA_KEY="mi_clave_secreta"
-python compilar_respuestas.py
-# genera respuestas.dat cifrado con XOR + zlib + base64
-```
----
-## Filtrado de licencias (NEO-2)
-NEO-2 clasifica las fuentes encontradas en tres categorías:
-| Categoría | Ejemplos | Acción |
-|---|---|---|
-| ✅ Permitida | Wikipedia, Archive.org, datos.gob.es | Usa el contenido |
-| ❓ Desconocida | Dominios sin licencia declarada | Usa como fallback |
-| ❌ Bloqueada | Sitios con CC BY-SA, BY-NC, ARR | Descarta silenciosamente |
-Si solo se encuentran fuentes bloqueadas, NEO muestra un mensaje explicativo en lugar de usar contenido no autorizado.
----
-## Licencia
-Distribuido bajo la licencia **Apache 2.0**. Consulta el archivo [LICENSE](LICENSE) para más detalles.
----
-## Autor
-**mdfjbotss** — [github.com/mdfjbotss](https://github.com/mdfjbotss)

 ---
+license: apache-2.0
+language:
+  - en
+  - es
+tags:
+  - chatbot
+  - rule-based
+  - roblox
+  - calculator
+  - gradio
+  - conversational
+  - web-search
+  - duckduckgo
+pipeline_tag: conversational
 ---
+# NEO-2 — mdfjbots
+> NEO-1 extended with real internet search (DuckDuckGo) filtered by content license. Only CC BY, CC0 and Public Domain sources are used.
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/)
+[![Gradio](https://img.shields.io/badge/gradio-4.44%2B-orange)](https://gradio.app/)
+## NEO-2 additions over NEO-1
+- **DuckDuckGo web search** — real queries when the knowledge base has no answer
+- **License filtering** — only uses CC BY, CC0 or Public Domain sources; blocks All Rights Reserved, CC BY-ND, CC BY-NC
+- **Abstractive summarization** — builds original prose from search results, never copies verbatim
+- **Session cache** — avoids re-searching the same query (up to 50 entries)
+- **Automatic retries** — retries up to 2 times with pause on network failure
+- **Typed errors** — distinguishes network failure, rate-limit and no-results for clear user messages
+## All NEO-1 features included
+JSON knowledge base · token similarity · response variation · streaming · calculator · Roblox API · closed edition · NeoAPI REST
+## Repository
+Source code: [github.com/mdfjbotss/neo-1](https://github.com/mdfjbotss/neo-1)
+## License
+Apache 2.0 — see [LICENSE](LICENSE)