This is a small MERN (MongoDB, Express.js, React, Node.js) project that illustrates integration with MongoDB's vector search, and AWS's Bedrock model hosting service.
You can run the development version with Docker Compose.
First, you must configure the application, using a .env file,
in the backend directory of the project. (The one that contains Dockerfile).
You need to set the following variables:
| Variable | Description |
|---|---|
| MONGODB_URI | The connection string (URI) for a MongoDB Atlas cluster. The connection string must contain the name of the database you want to connect to! |
| AWS_ACCESS_KEY | An AWS access key with permission to use the Bedrock service. |
| AWS_SECRET_KEY | The secret key associated with AWS_ACCESS_KEY. |
Once you've set those, you can execute the following command to install npm packages:
cd frontend && npm install && cd ../backend && npm install && cd ..And now, you can start up the application with:
docker-compose up --buildThis will spin up three containers:
| Service | Port | Description |
|---|---|---|
| Nginx | 8001 | A simple reverse-proxy that sits in front of frontend & backend, allowing them to be served from the same host & port. |
| Frontend | 8002 | A React application, created with create-react-app, and running in development mode. |
| Backend | 8003 | A Express.js application that routes requests from frontend to MongoDB & Amazon Bedrock. |
Both frontend and backend are configured to load any code changes made on-disk.
This is a small, stupidly-fast-moving project. Currently there are no tests (although there should be!), and no scripts for deployment. We'll get there!
All endpoints in the backend must be beneath the /api/ path prefix.
That's how Nginx knows to route to the backend, and not the frontend.