SousAI is a web application that features a recipe-generating AI assistant and a personalized recipe box. With SousAI, users can:
- Create Recipes: Use Sous, the AI-powered recipe assistant, to generate unique and tailored recipes.
- Save and Personalize: Save your favorite recipes to your personal recipe box, where you can add notes and photos for future reference.
- Customization: Input your cooking devices, ingredients, and dietary preferences to receive recipes specifically tailored to your desire.
SousAI is hosted at https://www.sousai.io/ using AWS and Heroku. The app is built with React, Redux, Node.js, PostgreSQL, and OpenAI's API.
- Create a database named
sous_ai
- Fork and clone this repository
- The queries in the database.sql file are set up to create all necessary tables and populate the needed data to allow the app to run correctly. The project is built on PostgreSQL, so you will need to have PostgreSQL installed for the app to work. We recommend using Postico to run those queries as that was used to create the queries.
- Open up your editor of choice and run an
npm install
- Run
npm run server
in your terminal - Run
npm run client
in your terminal - The
npm run client
command will open up a new browser tab for you
After starting the application:
- Register a new account for the app
- Navigate into the SousAI view once signed-in to the app
- Request a recipe of your choice using the input field at the bottom of the SousAI page
- Save a recipe that appeals to you using the button at the bottom of the recipe
- Navigate into the 'Saved recipes' page to view your saved recipes
- React.js - Frontend framework.
- Redux - State management.
- Node.js - Backend server.
- Express - Server framework.
- PostgreSQL - Database management.
- OpenAI's API - AI recipe generation.
Contributions are welcome. Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (git checkout -b feature/YourFeature).
- Commit your changes (git commit -m 'Add some feature').
- Push to the branch (git push origin feature/YourFeature).
- Open a pull request.
Thank you to Chris Black and Chris Cantoni for your contributions to the success of this project. I am also grateful to OpenAI for making their API available to build with.