{"id":28712861,"url":"https://github.com/gerardo1909/feelback","last_synced_at":"2026-04-05T23:03:24.257Z","repository":{"id":298731012,"uuid":"998413884","full_name":"Gerardo1909/FeelBack","owner":"Gerardo1909","description":"FeelBack es un proyecto personal que consite en una aplicación web simple tipo chat construida con Flask y un modelo de HuggingFace que permite a los usuarios analizar el sentimiento de textos en tiempo real.","archived":false,"fork":false,"pushed_at":"2025-08-07T20:34:29.000Z","size":4766,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-12T18:30:05.586Z","etag":null,"topics":["api-rest","chat-application","data-science","docker","flask","huggingface","nlp","postgresql","python","sentiment-analysis","trasnformers","website"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gerardo1909.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-08T15:03:18.000Z","updated_at":"2025-08-07T20:34:33.000Z","dependencies_parsed_at":"2025-06-12T15:42:10.678Z","dependency_job_id":"43f3e071-9324-466b-b85e-92f7a6f54e5f","html_url":"https://github.com/Gerardo1909/FeelBack","commit_stats":null,"previous_names":["gerardo1909/feelback"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Gerardo1909/FeelBack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerardo1909%2FFeelBack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerardo1909%2FFeelBack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerardo1909%2FFeelBack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerardo1909%2FFeelBack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gerardo1909","download_url":"https://codeload.github.com/Gerardo1909/FeelBack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gerardo1909%2FFeelBack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31452901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-rest","chat-application","data-science","docker","flask","huggingface","nlp","postgresql","python","sentiment-analysis","trasnformers","website"],"created_at":"2025-06-15T00:00:57.912Z","updated_at":"2026-04-05T23:03:24.232Z","avatar_url":"https://github.com/Gerardo1909.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FeelBack: Aplicación Web Interactiva para Análisis de Sentimientos\n\n| Estado de Build | Cobertura de Tests |\n|:--------------:|:------------------:|\n| ![Build Status](https://img.shields.io/badge/build-passing-brightgreen) | ![Coverage](https://img.shields.io/badge/coverage-84%25-brightgreen) |\n\n## Índice\n- [Descripción](#descripción)\n- [Tecnologías Utilizadas](#-tecnologías-utilizadas)\n- [Funcionalidades Principales](#-funcionalidades-principales)\n- [Estructura del Proyecto](#-estructura-del-proyecto)\n- [Endpoints de la API](#-endpoints-de-la-api)\n- [Dockerización](#-dockerización)\n- [Capturas de pantalla](#-capturas-de-pantalla)\n- [Contribución](#-contribución)\n- [Licencia](#-licencia)\n\n---\n\n## Descripción\n**FeelBack** es una aplicación web que combina inteligencia artificial y un diseño intuitivo para ofrecer análisis de sentimientos en tiempo real. Los usuarios pueden interactuar con un modelo de aprendizaje automático extraido de [**HuggingFace**](https://huggingface.co/nlptown/bert-base-multilingual-uncased-sentiment) a través de una interfaz tipo chat, obteniendo clasificaciones emocionales como **positiva**, **negativa** o **neutral**. Además, la aplicación permite a los usuarios gestionar su historial de análisis y explorar sus resultados de manera organizada.\n\n## 🚀 Tecnologías Utilizadas\n- **Lenguaje de programación:** Python\n- **Framework Backend:** Flask\n- **Modelo de ML:** BERT Multilingüe (nlptown/bert-base-multilingual-uncased-sentiment) de HuggingFace\n- **Librería de inferencia:** Transformers (HuggingFace)\n- **Base de datos:** PostgreSQL\n- **Contenerización:** Docker y Docker Compose\n\n## 🧩 Funcionalidades Principales\n\n![Funcionalidades Principales](./img/funcionalidades_principales.png)\n\n1. **Gestión de Usuarios**  \n   - Sistema de registro e inicio de sesión para proteger los datos personales de cada usuario.\n   - Cada usuario tiene acceso a su historial de análisis.\n2. **Interacción Conversacional**  \n   - Los usuarios pueden escribir comentarios en una interfaz tipo chat y recibir análisis de sentimientos en tiempo real.\n   - El modelo clasifica el texto en positivo, negativo o neutral.\n3. **Historial Personalizado**  \n   - Los usuarios pueden consultar sus análisis previos, filtrarlos por fecha o tipo de sentimiento, y exportarlos en formato CSV.\n\n## 📚 Estructura del Proyecto\n```bash\nFeelBack/\n├── web_app/                    # Aplicación web (Frontend + API Backend)\n│   ├── app/                    # Código fuente de la aplicación Flask\n│   │   ├── api/                # API RESTful: rutas para autenticación, chat y usuario\n│   │   ├── auth/               # Módulo de autenticación (formularios, rutas web)\n│   │   ├── main/               # Módulo principal (chat, historial, vistas web)\n│   │   ├── models/             # Modelos de datos (ORM)\n│   │   ├── static/             # Archivos estáticos (CSS, JS, imágenes)\n│   │   ├── templates/          # Plantillas HTML (Jinja2)\n│   │   ├── utils/              # Utilidades compartidas\n│   │   ├── __init__.py         # Inicialización y configuración de la aplicación Flask\n│   │   └── config.py           # Configuración general de la aplicación\n│   ├── Dockerfile              # Contenedor para la aplicación web\n│   ├── migrations/             # Migraciones de base de datos\n│   ├── tests/                  # Pruebas unitarias de la API y lógica\n│   ├── requirements.txt        # Dependencias de la aplicación web\n│   ├── run.py                  # Punto de entrada para ejecutar la aplicación\n│   └── setup.py                # Configuración del paquete\n├── img/                        # Imágenes para documentación\n├── docker-compose.yml          # Orquestación de servicios\n└── README.md                   # Documentación principal del proyecto\n```\n\n## 📖 Endpoints de la API\nA continuación se listan las rutas principales de la API RESTful expuesta por FeelBack agrupadas por funcionalidad:\n\n### Autenticación (`/api/v1/auth`)\n- **POST `/register`**: Registra un nuevo usuario.  \n  _Body_: username, email, password  \n  _Respuesta_: Mensaje de éxito o error.\n\n- **POST `/login`**: Inicia sesión y retorna un token JWT.  \n  _Body_: username, password  \n  _Respuesta_: token, user_id.\n\n- **POST `/verify-token`**: Verifica la validez de un token JWT.  \n  _Body_: token  \n  _Respuesta_: Mensaje de validez y user_id.\n\n### Chat y Análisis de Sentimientos (`/api/v1/chat`)\n- **POST `/get-sentiment`**: Analiza el sentimiento de un mensaje de texto.  \n  _Body_: message  \n  _Respuesta_: model_response (texto), id_sentiment (código de sentimiento).\n\n### Gestión de Mensajes e Historial (`/api/v1/user`)\n- **POST `/save-message`**: Guarda un mensaje analizado en el historial del usuario.  \n  _Body_: user_id, text, id_sentiment, liked  \n  _Respuesta_: Mensaje de éxito y id_message.\n\n- **POST `/delete-message`**: Elimina un mensaje del historial del usuario.  \n  _Body_: user_id, message_id  \n  _Respuesta_: Mensaje de éxito.\n\n- **GET `/get-message`**: Obtiene un mensaje específico del historial.  \n  _Body_: user_id, message_id  \n  _Respuesta_: Detalles del mensaje.\n\n- **GET `/get-messages`**: Obtiene todos los mensajes del usuario.  \n  _Body_: user_id  \n  _Respuesta_: Lista de mensajes.\n\n- **GET `/get-stats`**: Obtiene estadísticas de uso y sentimientos del usuario.  \n  _Body_: user_id  \n  _Respuesta_: Conteo de positivos, negativos, neutrales, likes y dislikes.\n\nEstas rutas permiten la integración con sistemas de monitoreo y dashboards de salud.\n\n#### Notas adicionales\n- Todas las rutas protegidas requieren autenticación mediante token JWT en el header `Authorization: Bearer \u003ctoken\u003e`.\n\n## 🐳 Dockerización\nFeelBack está completamente contenerizado para facilitar su despliegue y escalabilidad. Los servicios están orquestados mediante Docker Compose:\n```bash\n# Construcción de los contenedores\ndocker-compose build\n# Ejecución de los servicios\ndocker-compose up\n```\n\n## 📷 Capturas de pantalla\n### Página de Inicio\nPantalla de bienvenida con logo, mensaje introductorio y acceso rápido a registro o inicio de sesión. Diseño limpio, modular y responsivo.\n\n![Página de inicio](./img/pagina_inicio_1.png)\n![Página de inicio](./img/pagina_inicio_2.png)\n\n### Página de Inicio de Sesión\nFormulario sencillo para autenticación de usuarios, con validación y mensajes de error claros.\n\n![Página inicio](./img/pagina_login.png)\n\n### Página de Registro\nFormulario para crear una cuenta nueva, validación en tiempo real y confirmación de términos.\n\n![Página registro](./img/pagina_registro_cuenta_nueva.png)\n\n### Página de Interacción (Chat)\nInterfaz tipo chat para analizar sentimientos en tiempo real. Mensajes diferenciados y feedback visual.\n\n![Página interacción](./img/pagina_interaccion_1.png)\n![Página interacción](./img/pagina_interaccion_2.png)\n\n### Página de Historial\nHistorial de análisis con estadísticas, filtros, exportación a CSV y visualización clara de cada mensaje.\n\n![Página historial](./img/pagina_historial.png)\n\n### Página de Error\nPágina que se muestra en casos de presentar errores en la aplicación.\n\n![Página error](./img/pagina_error.png)\n\n## 🤝 Contribución\n¡Las contribuciones son bienvenidas! Por favor, abre un issue o pull request siguiendo las buenas prácticas de la comunidad.\n\n## 📝 Licencia\nEste proyecto está bajo la Licencia MIT.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerardo1909%2Ffeelback","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgerardo1909%2Ffeelback","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgerardo1909%2Ffeelback/lists"}