Austen: uma ferramenta de IA para analisar as relações entre personagens de livros e gerar gráficos

Introdução geral

O Austen é uma ferramenta de IA de código aberto que usa a estrutura Angular e a inicialização Analogjs, combinada com a tecnologia Mermaidjs para gerar gráficos que ajudam os usuários a analisar as relações entre personagens em livros. Os usuários podem inserir o nome do livro na Open Library, e a Austen gerará automaticamente um diagrama visual de relacionamento de personagens por meio de IA, além de permitir salvar, compartilhar e fazer download. A ferramenta é adequada para entusiastas da literatura, estudantes ou desenvolvedores, e o projeto é totalmente gratuito, hospedado no GitHub, para que qualquer pessoa possa participar de seu aprimoramento.

Lista de funções

• Pesquisar e analisar livrosSuporte à pesquisa de qualquer livro da Open Library e à análise de caracteres.
• Extração de relacionamentos de personagens orientada por IAUso de tecnologia de IA para reconhecer automaticamente personagens e seus relacionamentos em livros.
• Gerar gráfico do MermaidjsTradução de análises em diagramas de relacionamento intuitivos.
• Salvar e fazer download de gráficosGráficos: Os gráficos gerados podem ser salvos em um banco de dados e baixados no formato SVG ou PNG.
• Compartilhamento público ou privadoOs usuários têm a opção de tornar o gráfico público para que outros o vejam ou mantê-lo privado.
• Navegue pelos gráficos de outras pessoasVisualização de diagramas tornados públicos por outros usuários na página Descobrir.
• Função Likes (em desenvolvimento)No futuro, será possível curtir ou não curtir um gráfico favorito.

Usando a Ajuda

O Austen requer uma instalação local para ser executado e, no momento, não há versão on-line. Abaixo está um guia detalhado de instalação e uso para você começar.

Processo de instalação

1. Download do código do projeto
   Clone o projeto localmente digitando o seguinte comando no terminal:

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

Em seguida, vá para o diretório do projeto:

cd austen

2. Instalação de pacotes de dependência
   Use o npm para instalar os pacotes necessários:

npm install

3. Configuração de variáveis de ambiente
   Copie o arquivo de exemplo e renomeie-o .env::

cp .env.example .env

show (um ingresso) .env preencha as seguintes informações:

• DEEPSEEK_API_KEY: De DeepSeek A chave de API obtida ao se registrar no site oficial.
• VITE_PUBLIC_SUPABASE_URLURL do projeto Supabase.
• VITE_PUBLIC_SUPABASE_ANON_KEY: chave anônima do Supabase.
  Se desejar, a chave OpenAI também pode ser configurada (opcional).

4. Configuração do banco de dados do Supabase

• Acesse https://supabase.com para criar um novo projeto.
• Ativar a autenticação (Authentication).
• Criado em um esquema público graphs com os seguintes campos:
  • id(uuid, chave primária)
  • book_name(texto, não vazio)
  • author_name(texto, não vazio)
  • svg_graph(texto, não vazio)
  • mermaid_syntax(texto, não vazio)
  • emojis(texto, opcional)
  • user_id(uuid)
  • is_public(booleano, padrão false)
  • created_at(registro de data e hora)
    Depois de salvar, preencha o URL do projeto e a chave anônima no campo .env.

5. Iniciando o servidor local
   Digite o seguinte comando para executar o projeto:

npm run dev

Abra seu navegador e acesse http://localhost:5173(As portas podem variar de acordo com a configuração).

6. Implementação no ambiente de produção
   Se você quiser implementar em um servidor, execute-o:

npm run build

Depois de criado, ele pode ser carregado em plataformas como a Cloudflare Pages.

Como usar os principais recursos

• Gerar diagramas de relacionamento de funções
  Uma vez iniciado, digite o título e o autor do livro (por exemplo, "O Mágico de Oz", de L. Frank Baum) na primeira página. Clique em "Generate" (Gerar) e a IA analisará o conteúdo do livro e exibirá um gráfico do Mermaidjs após alguns segundos. O gráfico mostra as relações entre os personagens, como a relação de "estimação" de Dorothy e Totó.
• Salvar e fazer download de gráficos
  Depois de gerar o gráfico, clique no botão Save (Salvar) e os dados serão armazenados no Supabase. Você pode fazer o download do gráfico no formato SVG ou PNG para facilitar o compartilhamento ou a impressão.
• Gráfico de ações
  Na página My Diagrams (Meus diagramas), localize o diagrama que você criou. Selecione a opção "Public" (Público) para que outros usuários possam vê-lo na página "Discover" (Descobrir). Se não quiser compartilhá-lo, mantenha-o privado.
• Navegue pelos gráficos de outras pessoas
  Na página "Discover" (Descobrir), você pode visualizar gráficos tornados públicos por outros usuários. Por exemplo, alguém compartilhou um gráfico de relacionamento de personagens para Orgulho e Preconceito, que você pode apreciar diretamente.
• Função Likes (a ser implementada)
  A versão atual ainda não tem um botão de curtir. Os desenvolvedores planejam adicionar os recursos "like" e "unlike", que permitirão que você vote nos seus gráficos favoritos.

Exemplo de fluxo de operação

Quer analisar O Mágico de Oz? Experimente este passo a passo:

1. Digite o título "The Wizard of Oz" (O Mágico de Oz) e o autor "L. Frank Baum" na primeira página.
2. Clique em "Generate" (Gerar) e aguarde alguns segundos.
3. Dê uma olhada nos gráficos: Dorothy é a peça central, com conexões com Toto, Scarecrow e outros.
4. Clique em "Save" (Salvar) e selecione "Public" (Público).
5. Vá para a página My Diagrams (Meus diagramas) para fazer o download do arquivo SVG ou consulte a página Discover (Descobrir) para obter feedback de outras pessoas.

Detalhes técnicos

• A interface é baseada no Angular Material, que é bonito e fácil de usar.
• Os gráficos são desenhados pelo Mermaidjs e suportam cores de tema personalizadas.
• A análise de IA depende do DeepSeek ou do OpenAI para garantir resultados precisos.

cenário do aplicativo

1. Estudos literários
   Os entusiastas podem usar Austen para analisar a rede de personagens em Jane Eyre e visualizar o relacionamento entre Jane e Rochester.
2. ensino em sala de aula
   O professor gera um gráfico de Harry Potter para ajudar os alunos a entender a amizade de Harry, Ron e Hermione.
3. Aprendizagem técnica
   Os desenvolvedores podem estudar o código e aprender a criar ferramentas semelhantes com o Angular e o Supabase.

QA

1. Quais livros são compatíveis?
   Qualquer livro para o qual a Open Library tenha dados serve, como Orgulho e Preconceito, O Mágico de Oz.
2. Os gráficos podem ser editados?
   A versão atual não oferece suporte à edição direta, mas você pode modificar o código do Mermaidjs e gerá-lo novamente.
3. Preciso pagar?
   Não é necessário, o projeto é totalmente gratuito. Mas para executá-lo é necessário configurar a chave da API e o Supabase por conta própria.
4. Por que usar o Supabase?
   Ele é responsável por armazenar dados de gráficos, oferecer suporte ao compartilhamento público e ao gerenciamento de usuários.