Skip to content

EL-BID/Interview-GPT-UI

Repository files navigation

Interview GPT

Ayuda a los equipos a recopilar datos cualitativos mediante entrevistas conversacionales


Índice

  1. ¿Qué es Interview GPT?
  2. Características principales
  3. Guía de instalación
  4. Despliegue para producción
  5. Contribuciones
  6. Autores
  7. Licencia

¿Qué es Interview GPT?

Interview GPT es una aplicación web desarrollada con React y TypeScript, diseñada para facilitar la recolección de datos cualitativos a través de experiencias conversacionales. Ofrece dos modos de interacción:

  • Chat: todas las preguntas y respuestas aparecen en un hilo continuo.
  • Secuencial: cada pregunta se muestra por separado, ayudando al entrevistado a centrarse en un sólo ítem a la vez.

La plataforma adopta un enfoque mobile-first, optimizado para que los usuarios puedan completar entrevistas desde cualquier dispositivo. Además:

  • Permite responder por texto o usando el micrófono.
  • Al finalizar, muestra un análisis configurado por el administrador, basado en las respuesta.
  • Dispone de un panel de administración con los resultados agrupados por entrevista, chart con el avance de las entrevistas llenadas con respecto a las creadas, y chat en vivo para profundizar en hallazgos.

Interview GPT es un proyecto compuesto por tres repositorios:


Características principales

  • Dos modos de entrevista: chat y secuencial.
  • Respuestas por texto o voz.
  • Análisis automático al finalizar cada entrevista.
  • Panel para administradores.
  • Chat en vivo para seguimiento y asistencia para el administrador.
  • Analisis sobre los resultados con insights para el administrador.
  • Mobile-first: interfaz responsiva.

Guía de instalación

3.1 Requisitos del sistema operativo

  • macOS, Windows 10/11 o cualquier distribución moderna de Linux
  • Node.js v16.x
  • npm v8
  • Git v2.34 o superior (para clonar el repositorio)

3.2 Instalación de dependencias

3.3 Ejecución en desarrollo

npm start

Se abrirá la aplicación en http://localhost:3000.

3.4 Despliegue para producción

npm run build

El resultado se generará en la carpeta build/, listo para servir con tu servidor estático favorito (e.g., Nginx, Firebase Hosting).

3.5 Configuración

El funcionamiento del proyecto depende de la configuración de variables de ambiente para establecer la ubicación del Backend (API) y la autenticación para el módulo administrativo. La configuración se hace creando un archivo .env en el directorio raíz (ver archivo .env.example para ver un ejemplo de este archivo).

3.6 Autenticación

Actualmente, el proyecto solamente soporta autenticación vía Microsoft Entra ID (Azure Active Directory). Esta autenticación y gestión de tokens de acceso se realiza mediante la librería de MSAL de Microsoft.

Contributions

Gracias por tu interés en mejorar Interview GPT.

Actualmente no aceptamos pull requests directos a este repositorio. Sin embargo, si deseas explorar el código, desarrollar nuevas funcionalidades o proponer mejoras, te animamos a crear tu propia versión del proyecto (mediante fork o clonación).

Si tienes sugerencias, detectaste algún error o deseas compartir una propuesta de mejora, no dudes en escribirnos a:
[email protected]

Estaremos encantados de conocer tus ideas y colaborar en su desarrollo.

Autores

Alejandra Pérez Ortega

Jhoselyn Pajuelo Villanueva

Ignacio Cerrato

José Daniel Zárate

Licencia

License.md


Interview GPT

**Helps teams to collect qualitative data through conversational interviewing


Table of contents

  1. What is Interview GPT
  2. Main features
  3. Installation guide
    • 3.1 Operating system requirements](#31-operating-system-requirements)
    • 3.2 Installing dependencies](#33-installing-dependencies)
    • 3.3 Execution-in-development](#34-execution-in-development)
  4. Deployment for production
  5. Contributions
  6. Authors
  7. License

What is Interview GPT?

Interview GPT is a web application developed with React and TypeScript, designed to facilitate the collection of qualitative data through conversational experiences. It offers two modes of interaction:

  • Chat: all questions and answers appear in a continuous thread.
  • Sequential: each question is displayed separately, helping the respondent to focus on a single item at a time.

The platform takes a mobile-first approach, optimized so users can complete interviews from any device. In addition:

  • Allows you to respond by text or using the microphone.
  • At the end, it displays an analysis configured by the administrator, based on the answers.
  • It has an administration panel with the results grouped by interview, chart with the progress of the completed interviews with respect to the created ones, and live chat to deepen the findings.

Interview GPT includes 3 repositories:


Main features

  • Two interview modes: chat and sequential.
  • Text or voice responses.
  • Automatic analysis at the end of each interview.
  • Panel for administrators.
  • Live chat for follow-up and assistance for the administrator.
  • Analysis of results with insights for the administrator.
  • Mobile-first: responsive interface.

Installation guide

3.1 Operating system requirements

  • macOS, Windows 10/11 or any modern Linux distribution
  • Node.js v16.x
  • npm** v8
  • Git v2.34 or higher (to clone the repository)

3.2 Installing dependencies

3.3 Running in development

npm start

The application will open at http://localhost:3000.

3.4 Production deployment

npm run build

The output will be generated in the build/ folder, ready to serve with your favorite static server (e.g., Nginx, Firebase Hosting).

3.5 Configuration

The operation of the project depends on the configuration of environment variables to set the location of the Backend (API) and the authentication for the administrative module. The configuration is done by creating an .env file in the root directory (see .env.example file for an example of this file).

3.6 Authentication

Currently, the project only supports authentication via Microsoft Entra ID (Azure Active Directory). This authentication and access token management is done via Microsoft's MSAL library.

Contributions

Thank you for your interest in improving Interview GPT.

We do not currently accept direct pull requests to this repository. However, if you wish to explore the code, develop new features or propose improvements, we encourage you to create your own version of the project (by fork or cloning).

If you have suggestions, detected a bug or want to share an improvement proposal, feel free to write to us at:
[email protected]

We will be happy to hear your ideas and collaborate in its development.

Authors

Alejandra Pérez Ortega

Jhoselyn Pajuelo Villanueva

Ignacio Cerrato

José Daniel Zárate

License

License.md

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages