Skip to content

danielh-hong/hackthenorth2024

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LureLore (2024 HTN Finalist) - $5000+

TLDR:

Caught a fish? Take a snap. Our AI-powered app identifies the catch, keeps track of stats, and puts that fish in your 3d, virtual aquarium which you can interact with. It's a wholesome way for fishing enthusiasts to reminisnce upon the 'good old days' years into the future. Also, click on any fish in the aquarium, and see all those fishes stats, including date caught, location caught, and a funny joke making ever the more memorable.

Depending on the fish caught, also reel in achievements. Keep track of your first fish caught, your first tropical fish caught, or your first 20+ pound fish! The cherry on top? See on the map where other fish are caught around the world, so that the one fish you've always wanted might just be your next catch.

But remember, Lure lore isn't just about catching fish -- its's about catching lifelong memories.

Description

LureLore is an app made to enhance the fishing experience by turning each catch into a rich, interactive memory. Using AI technology, it transforms simple fish photos into comprehensive records complete with species identification, rarity ratings, and AI-generated stories.

What's the opportunity?

Many fishing enthusiasts struggle to keep track of their catches in a meaningful way, often relying on basic photos that fail to capture the full experience. LureLore solves this by transforming each catch into a rich, interactive memory complete with AI-generated stories, rarity ratings, and a virtual aquarium, turning fleeting moments into lasting, shareable experiences.

Features

  • Fish species identification using AI
  • Rarity rating for each catch
  • Location and time tracking
  • AI-generated "Fish Tale" for each catch
  • Virtual aquarium displaying all past catches
  • Interactive dashboard to view and manage catches
  • Detailed view for each fish with all recorded information

Technologies Used

  • Frontend: React, Three.js
  • Backend: Node.js, Express
  • Database: MongoDB Atlas
  • AI: Google's Gemini API
  • Leaflet API

Installation

  1. Clone the repository:

    git clone [repository URL]
    
  2. Install backend dependencies:

    cd backend
    npm install
    
  3. Install frontend dependencies:

    cd ../frontend
    npm install
    

Running the Application

  1. Start the backend server:

    cd backend
    node server2.js
    
  2. In a new terminal, start the frontend:

    cd frontend
    npm run dev
    
  3. Open your browser and navigate to http://localhost:5173

Screenshots

Screenshot 2024-09-15 at 6 51 24 AM Screenshot 2024-09-15 at 6 52 05 AM

Future Features

In the future, we aim to add more 3d fish into the library, which was our main limitation; after all, there's no way to automatically create a 3d fish model for every existing fish. We also aim to improve the 3d scene. So far, we've already curated a scene (which we like to think looks pretty good) of 3d bubbles, simulated realistic fish movement, a nice underwater background, corals, and underwater lighting. But obviously, there's always improvement to be made :)

Contributing

We welcome contributions to LureLore! If you have suggestions for improvements or bug fixes, please follow these steps:

  1. Fork the repository
  2. Create a new branch for your feature (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Contributors

  • Daniel Hong
  • David Zhuang
  • Aaron Loh
  • Avery Chan

Thank you for your interest in LureLore! We hope it enhances your fishing experience and helps you create lasting memories of your catches.

About

Hack The North 2024 Finalists ($5000+)

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors