This guide provides instructions for setting up the Grocery List App in a local development environment. This app is a web-based tool that allows users to upload images of their handwritten grocery lists, which are then transcribed and organized into a structured format.
Clone the Repository
Clone the repository to your local machine using the following command:
git clone [repository-url]
Install Dependencies
Navigate to the cloned directory and install the necessary Node.js packages:
cd [repository-directory]
npm install
Set Up Environment Variables
Create a .env
file in the root directory of the project and add the following variables:
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=your_redis_password
SECRET_KEY_BASE=your_secret_key
BASIC_AUTH_USERNAME=your_username
BASIC_AUTH_PASSWORD=your_password
OPENAI_API_KEY=your_openai_api_key
Replace your_redis_password
, your_secret_key
, your_username
, your_password
, and your_openai_api_key
with your Redis password, a secret key for sessions, basic authentication credentials, and your OpenAI API key, respectively.
Start Redis Server
Ensure that your Redis server is running. You can start Redis using the following command:
redis-server
Run the Application
Start the server by running:
npm start
By default, the server will start on http://localhost:3000
.
Access the Application
Open a web browser and navigate to http://localhost:3000
to use the app.
.env
file..env
file match your local Redis configuration..env
file contains the correct host, port, and password..env
file.Feel free to open an issue on the repository if you encounter any problems not covered in this guide.