Skip to content

Latest commit

 

History

History
45 lines (28 loc) · 3.5 KB

README.md

File metadata and controls

45 lines (28 loc) · 3.5 KB
Raw

Museo Insight App

Maintenance Maintainer Ask Me Anything ! License GitHub release

Museo Insight is an intelligent virtual museum guide that brings art to life by providing users with rich, contextual information on a wide range of artworks. Built using Java 21, Spring Boot 3.3.3, and LangChain4J, the app seamlessly integrates with the MET Museum's API to allow users to search by department, explore specific works, and view images directly from one of the world’s largest art collections. Through AI-powered analysis, each piece is described in depth, highlighting its historical and cultural significance, visual style, artist background, and year of creation.

screen-capture.mp4

Key Features

  • Comprehensive Art Search and Exploration: Users can search for artworks across various departments and collections from the MET Museum's vast online database. The app provides access to high-quality images, enabling users to explore the details of each piece closely.
  • AI-Powered Artwork Descriptions: Leveraging LangChain4J, the AI generates rich, contextual descriptions for each artwork, covering historical background, cultural significance, visual composition, artist biography, and the artwork’s creation year. This feature allows users to gain a deeper understanding and appreciation of each piece.
  • Virtual Museum Guide Experience: The app functions as a knowledgeable museum guide, curating information and narrating each artwork’s story. It provides users with an immersive experience as they explore each piece with personalized, AI-generated insights.
  • Real-Time Image Analysis and Interpretation: By analyzing each artwork image, the AI can offer visual insights such as color composition, style, and symbolic elements, helping users understand the artist's technique and message.
  • Dynamic and User-Friendly API: Designed with intuitive API, users can smoothly browse collections, select pieces of interest, and read detailed descriptions. The UI ensures that each piece of information is easy to access and visually engaging.
  • Educational Resource for Art Enthusiasts and Students: Museo Insight serves as a valuable resource for art history students, educators, and enthusiasts by providing reliable, well-researched information and deep contextual understanding that enriches learning experiences.

Tech Stack

  • Java 21
  • SpringBoot 3.3.3: Backend framework for building fast and scalable applications.
  • Metmuseum API: Provides images of artworks.
  • Together AI: Provides models for describe image. Model: Meta Llama 3.2 90B Vision Instruct Turbo
  • Langchain4j: Supercharge your Java application with the power of LLMs.

Running On Local Machine (Linux):

  1. Set up the following environment variables.
    • export AI_API_KEY=your_api_key;
  2. Run the command: mvn exec:java -Dspring.profiles.active=local
  3. Open the following link in your browser: http://localhost:8208/api/swagger-ui/index.html#/

Contributing

Feel free to open issues or submit pull requests to improve the project. Contributions are welcome!