Ayuda a los equipos a recopilar datos cualitativos mediante entrevistas conversacionales
- ¿Qué es Interview GPT?
- Características principales
- Guía de instalación
- Despliegue para producción
- Contribuciones
- Autores
- Licencia
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:
- Interfaz Web (UI): EL-BID/Interview-GPT-UI
- Backend: EL-BID/Interview-GPT-backend
- AI API: EL-BID/Interview-GPT-AI-API
- 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.
- 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)
-
create a file .env following ""example.env""
-
cd interview-gpt/webapp
-
npm install
npm start
Se abrirá la aplicación en http://localhost:3000.
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).
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).
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.
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:
techlab@iadb.org
Estaremos encantados de conocer tus ideas y colaborar en su desarrollo.
Alejandra Pérez Ortega
Jhoselyn Pajuelo Villanueva
Ignacio Cerrato
José Daniel Zárate
License.md
**Helps teams to collect qualitative data through conversational interviewing
- What is Interview GPT
- Main features
- 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)
- Deployment for production
- Contributions
- Authors
- License
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:
- Web Interface (UI): EL-BID/Interview-GPT-UI
- Backend: EL-BID/Interview-GPT-backend
- AI API: EL-BID/Interview-GPT-AI-API
- 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.
- macOS, Windows 10/11 or any modern Linux distribution
- Node.js v16.x
- npm** v8
- Git v2.34 or higher (to clone the repository)
-
cd interview-gpt/webapp
-
npm install
npm start
The application will open at http://localhost:3000.
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).
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).
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.
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:
techlab@iadb.org
We will be happy to hear your ideas and collaborate in its development.
Alejandra Pérez Ortega
Jhoselyn Pajuelo Villanueva
Ignacio Cerrato
José Daniel Zárate
License.md
Copyright © [2025]. Inter-American Development Bank ("IDB"). Authorized Use.
The procedures and results obtained based on the execution of this software are those programmed by the developers and do not necessarily reflect the views of the IDB, its Board of Executive Directors or the countries it represents.
Copyright © [2025]. Banco Interamericano de Desarrollo ("BID"). Uso Autorizado.
Los procedimientos y resultados obtenidos con la ejecución de este software son los programados por los desarrolladores y no reflejan necesariamente las opiniones del BID, su Directorio Ejecutivo ni los países que representa.
Copyright © [2025]. Inter-American Development Bank ("IDB"). The Support and Usage Documentation is licensed under the Creative Commons License CC-BY 4.0 license. The opinions expressed in the Support and Usage Documentation are those of its authors and do not necessarily reflect the opinions of the IDB, its Board of Executive Directors, or the countries it represents.
Copyright © [2025]. Banco Interamericano de Desarrollo (BID). La Documentación de Soporte y Uso está licenciada bajo la licencia Creative Commons CC-BY 4.0. Las opiniones expresadas en la Documentación de Soporte y Uso son las de sus autores y no reflejan necesariamente las opiniones del BID, su Directorio Ejecutivo ni los países que representa.
The Software may include features which use, are powered by, or are an artificial intelligence system (“AI-Powered Services”), and as a result, the services provided via the Software may not be completely error-free or up to date. Additionally, the User acknowledges that due to the incorporation of AI-Powered Services in the Software, the Software may not dynamically (in “real time”) retrieve information and that, consequently, the output provided to the User may not account for events, updates, or other facts that have occurred or become available after the Software was trained. Accordingly, the User acknowledges that the use of the Software, and that any actions taken or reliance on such products, are at the User’s own risk, and the User acknowledges that the User must independently verify any information provided by the Software.
El Software puede incluir funciones que utilizan, están impulsadas por o son un sistema de inteligencia artificial (“Servicios Impulsados por IA”) y, como resultado, los servicios proporcionados a través del Software pueden no estar completamente libres de errores ni actualizados. Además, el Usuario reconoce que, debido a la incorporación de Servicios Impulsados por IA en el Software, este puede no recuperar información dinámicamente (en “tiempo real”) y que, en consecuencia, la información proporcionada al Usuario puede no reflejar eventos, actualizaciones u otros hechos que hayan ocurrido o estén disponibles después del entrenamiento del Software. En consecuencia, el Usuario reconoce que el uso del Software, y que cualquier acción realizada o la confianza depositada en dichos productos, se realiza bajo su propio riesgo, y reconoce que debe verificar de forma independiente cualquier información proporcionada por el Software.