Juno

Juno is an AI marketing assistant for small business owners
Explore the code »

About The Project

Juno is an AI marketing assistant that helps small business owners create marketing campaigns. It gives owners recommendations based on upcoming events that are within the context of their business, and it generates different types of flyers that the user can download.

(back to top)

Built With

• 
• 
• 
• 

(back to top)

Getting Started

To get a local copy up and running follow these steps.

Prerequisites

• npm

  npm install npm@latest -g

• Firebase project

  • To create a Firebase project go to this link and follow the instructions
  • Make sure to create a web app which will generate the necessary API keys and config values for your website to connect to Firebase

• Gemini API Key

  • Get a free API Key here
  • Make sure your API Key is associated with the same Firebase project you created

• Google Maps API Key

  • Get a free API Key here
  • Again, make sure the key is associated with your Firebase project
  • Make sure the key is unrestricted

Installation

1. Clone the repo

   git clone https://github.com/394-w25/Juno.git

2. Install NPM packages

   npm install

3. Enter your API in .env

    VITE_GEMINI_API_KEY=YOUR_GEMINI_API_KEY
    VITE_GOOGLE_MAPS_API_KEY=YOUR_GOOGLE_MAPS_API_KEY
    VITE_FIREBASE_KEY=YOUR_FIREBASE_KEY
    VITE_AUTH_DOMAIN=YOUR_FIREBASE_AUTH_DOMAIN
    VITE_PROJECT_ID=YOUR_FIREBASE_PROJECT_ID
    VITE_STORAGE_BUCKET=YOUR_FIREBASE_STORAGE_BUCKET
    VITE_MESSAGING_SENDER_ID=YOUR_FIREBASE_MESSAGING_SENDER_ID
    VITE_APP_ID=YOUR_FIREBASE_APP_ID
    VITE_MEASUREMENT_ID=YOUR_FIREBASE_MEASUREMENT_ID

4. Change git remote url to avoid accidental pushes to base project

   git remote set-url origin your_github_username/your_repo_name
   git remote -v # confirm the changes

(back to top)

Usage

To run the app:

npm start

(back to top)

Known Issues

• For some reason, if the user logs in with an account, they're unable to navigate to the dashboard to sign out
• There is very limited UI support for mobile
• From time to time, the app may crash because Gemini returned an incorrectly formatted response. We tried our best to catch these errors but some still slip through.
• Chat logs in both the Operator and Creator page are not saved

(back to top)

Top Contributors

Vivian Chen, Andy Vu, Clement Kubica, Yvonne Cheng, Yosief Desta, Archie Silverstein, and Victor Olawale-apanpa created version 1 of this app.