https://github.com/schmitzandrew/lahacks2024travel

A tour guide made with Gemini
https://github.com/schmitzandrew/lahacks2024travel

flask gemini google-maps nextjs python tailwind

Last synced: about 1 month ago
JSON representation

A tour guide made with Gemini

• Host: GitHub
• URL: https://github.com/schmitzandrew/lahacks2024travel
• Owner: SchmitzAndrew
• Created: 2024-04-20T02:01:21.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-04-21T12:55:27.000Z (9 months ago)
• Last Synced: 2024-10-19T06:03:05.120Z (3 months ago)
• Topics: flask, gemini, google-maps, nextjs, python, tailwind
• Language: TypeScript
• Homepage: https://lahacks2024travel.vercel.app
• Size: 436 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Hermes - Our LA Hacks 2024 Project

![image](https://github.com/SchmitzAndrew/lahacks2024travel/assets/8219702/4c398586-057f-4a69-8043-4175b61eec12)

## Demo Link

https://lahacks2024travel.vercel.app/

## What is Hermes?

Hermes is a webapp that lets people tour new places without being tethered to an expensive travel guide. Hermes creates a cohesive storyline as it helps you navigate the physical, historical, and cultural world of wherever you end up.

## How was Hermes built?

Hermes was built with a Next.js and TailwindCSS frontend, Python/ Flask backend, and a mix of APIs and SDKs including Elevenlabs' Speech Synthesis SDK, the Google Maps API, and Google Gemini.

## How can I run Hermes locally?

### Running the backend

1. Create a python virtual environment and cd into the backend folder

2. Run `pip install -r requirements.txt` to install the necessary pip packages

3. Rename .env.example to .env and paste in your relevant API keys

4. Run `python api.py` to run the Hermes web server

### Running the frontend

1. Install a recent version of Node.js (preferrably using nvm)

2. Cd into the web folder and run `npm i` to install the necessary npm packages

3. Rename .env.example to .env and paste in your relevant API keys

4. Run `npm run dev` to spin up the Next.js app