Austen: una herramienta de IA para analizar las relaciones entre los personajes de un libro y generar gráficos

Introducción general

Austen es una herramienta de IA de código abierto que utiliza el framework Angular y la inicialización Analogjs, combinados con la tecnología Mermaidjs para generar diagramas que ayudan a los usuarios a analizar las relaciones entre personajes en los libros. Los usuarios pueden introducir el nombre del libro en la Open Library, Austen generará automáticamente un diagrama visual de relaciones entre personajes mediante IA, y admite guardar, compartir y descargar. La herramienta es adecuada para entusiastas de la literatura, estudiantes o desarrolladores, y el proyecto es completamente gratuito, alojado en GitHub, por lo que cualquiera puede participar en su mejora.

Lista de funciones

• Buscar y analizar libros: Admite la búsqueda de cualquier libro de Open Library y la realización de análisis de caracteres.
• Extracción de relaciones entre personajes mediante IA: Utilización de la tecnología de IA para reconocer automáticamente a los personajes y sus relaciones en los libros.
• Generar gráfico Mermaidjs: Traduzca los análisis en diagramas de relaciones intuitivos.
• Guardar y descargar gráficosLos gráficos generados pueden guardarse en una base de datos y descargarse en formato SVG o PNG.
• Uso compartido público o privadoLos usuarios tienen la opción de hacer público el gráfico para que otros lo vean o mantenerlo privado.
• Consulta las cartas de otros usuariosPermite ver los diagramas publicados por otros usuarios en la página Descubrir.
• Función Likes (en desarrollo): En el futuro será posible dar me gusta o no a un gráfico favorito.

Utilizar la ayuda

Austen requiere una instalación local para funcionar y actualmente no existe una versión en línea. A continuación encontrará una guía detallada de instalación y uso para empezar.

Proceso de instalación

1. Descargar el código del proyecto
   Clona el proyecto localmente introduciendo el siguiente comando en el terminal:

git clone https://github.com/herol3oy/austen.git

A continuación, vaya al directorio del proyecto:

cd austen

2. Instalación de paquetes de dependencias
   Utilice npm para instalar los paquetes necesarios:

npm install

3. Configuración de variables de entorno
   Copie el archivo de ejemplo y cámbiele el nombre .env::

cp .env.example .env

espectáculo (una entrada) .env rellene la siguiente información:

• DEEPSEEK_API_KEY: De DeepSeek La clave API obtenida al registrarse en el sitio web oficial.
• VITE_PUBLIC_SUPABASE_URLURL del proyecto Supabase.
• VITE_PUBLIC_SUPABASE_ANON_KEY: Clave anónima de Supabase.
  Si se desea, también se puede configurar la clave OpenAI (opcional).

4. Configuración de la base de datos Supabase

• Visite https://supabase.com para crear un nuevo proyecto.
• Activar la autenticación (Autenticación).
• Creado en esquema público graphs con los siguientes campos:
  • id(uuid, clave primaria)
  • book_name(texto, no vacío)
  • author_name(texto, no vacío)
  • svg_graph(texto, no vacío)
  • mermaid_syntax(texto, no vacío)
  • emojis(texto, opcional)
  • user_id(uuid)
  • is_public(booleano, por defecto falso)
  • created_at(marca de tiempo)
    Después de guardar, introduzca la URL del proyecto y la clave anónima en el campo .env.

5. Iniciar el servidor local
   Introduzca el siguiente comando para ejecutar el proyecto:

npm run dev

Abra su navegador y visite http://localhost:5173(Los puertos pueden variar según la configuración).

6. Implantación en el entorno de producción
   Si quieres desplegarlo en un servidor, ejecútalo:

npm run build

Una vez construido, se puede subir a plataformas como Cloudflare Pages.

Cómo utilizar las principales funciones

• Generar diagramas de relación de funciones
  Una vez iniciada, introduce el título y el autor del libro (por ejemplo, "El mago de Oz", de L. Frank Baum) en la primera página. Haz clic en "Generar" y la IA analizará el contenido del libro y mostrará un gráfico Mermaidjs al cabo de unos segundos. El gráfico muestra las relaciones entre los personajes, como la relación de "mascota" entre Dorothy y Toto.
• Guardar y descargar gráficos
  Después de generar el gráfico, haz clic en el botón Guardar y los datos se almacenarán en Supabase. Puedes descargar el gráfico en formato SVG o PNG para compartirlo o imprimirlo fácilmente.
• Compartir gráfico
  En la página "Mis diagramas", busca el diagrama que has creado. Selecciona la opción "Público" para que otros usuarios puedan verlo en la página "Descubrir". Si no quieres compartirlo, mantenlo privado.
• Consulta las cartas de otros usuarios
  En la página "Descubrir" puedes ver los gráficos publicados por otros usuarios. Por ejemplo, alguien ha compartido un gráfico de relaciones entre personajes de Orgullo y prejuicio, que puedes disfrutar directamente.
• Función Likes (por implementar)
  La versión actual aún no tiene botón "Me gusta". Los desarrolladores tienen previsto añadir las funciones "me gusta" y "no me gusta", que te permitirán votar por tus gráficos favoritos.

Ejemplo de flujo de operaciones

¿Quieres analizar El Mago de Oz? Prueba este paso a paso:

1. Escriba el título "El Mago de Oz" y el autor "L. Frank Baum" en la primera página.
2. Haga clic en "Generar" y espere unos segundos.
3. Echa un vistazo a los gráficos: Dorothy es la pieza central, con conexiones con Toto, Scarecrow y más.
4. Haz clic en "Guardar" y selecciona "Público".
5. Vaya a la página Mis diagramas para descargar el archivo SVG, o consulte la página Descubrir para ver los comentarios de los demás.

Ficha técnica

• La interfaz se basa en Angular Material, que es bonito y fácil de usar.
• Los gráficos son dibujados por Mermaidjs y admiten colores temáticos personalizados.
• El análisis de IA se basa en DeepSeek u OpenAI para garantizar resultados precisos.

escenario de aplicación

1. Estudios literarios
   Los aficionados pueden utilizar a Austen para analizar la red de personajes de Jane Eyre y visualizar la relación entre Jane y Rochester.
2. enseñanza en el aula
   El profesor elabora una tabla de Harry Potter para ayudar a los alumnos a comprender la amistad de Harry, Ron y Hermione.
3. Aprendizaje técnico
   Los desarrolladores pueden estudiar el código y aprender a crear herramientas similares con Angular y Supabase.

CONTROL DE CALIDAD

1. ¿Qué libros se admiten?
   Cualquier libro del que Open Library tenga datos es válido, como Orgullo y prejuicio o El mago de Oz.
2. ¿Se pueden editar los gráficos?
   La versión actual no permite la edición directa, pero puedes modificar el código Mermaidjs y regenerarlo.
3. ¿Tengo que pagar?
   No es necesario, el proyecto es completamente gratuito. Pero ejecutarlo requiere configurar la clave API y Supabase usted mismo.
4. ¿Por qué Supabase?
   Se encarga de almacenar los datos de los gráficos, de compartirlos con el público y de gestionar a los usuarios.