austen  by herol3oy

AI app for discovering story relationships in books

created 10 months ago
337 stars

Top 82.9% on sourcepulse

GitHubView on GitHub
Project Summary

Austen is an AI-powered web application designed to visualize character relationships within books. It targets readers and literary enthusiasts who want to explore narrative structures and character dynamics, offering a unique way to discover and share insights into literary works.

How It Works

The application leverages AI to analyze book content, identifying characters and their relationships. It then uses Mermaid.js to generate interactive diagrams representing these connections. The architecture is built with Angular and Analog.js, utilizing Supabase for backend services and Cloudflare Pages for deployment.

Quick Start & Requirements

  • Install dependencies: npm install
  • Environment variables: Copy .env.example to .env and fill in DEEPSEEK_API_KEY, VITE_PUBLIC_SUPABASE_URL, and VITE_PUBLIC_SUPABASE_ANON_KEY.
  • Supabase setup: Requires a Supabase project with authentication enabled and a graphs table.
  • Development server: npm run dev
  • Production build: npm run build
  • Prerequisites: Node.js, npm, DeepSeek API key, Supabase project.

Highlighted Details

  • AI-powered character relationship analysis.
  • Generates interactive Mermaid.js diagrams.
  • Supports saving, downloading (SVG, PNG), and sharing graphs.
  • Integrates with Open Library for book data.
  • Deploys on Cloudflare Pages.

Maintenance & Community

The project is maintained by herol3oy. There are no explicit mentions of community channels or roadmap in the README.

Licensing & Compatibility

Licensed under the MIT License. This license is permissive and generally compatible with commercial use and closed-source linking.

Limitations & Caveats

The project is under active development with several features listed as "TODO," including like/unlike functionality for graphs and implementing a "load more" feature for the discover page. The AI analysis quality is dependent on the underlying DeepSeek model.

Health Check
Last commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
15 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.