SmartCart v3

• frontend/ – Next.js dashboard
• backend/ – FastAPI API + ML pipeline

This project requires python>=3.12.

Getting Started

First, download Node.js v24.11.1 (LTS) and verify it is installed:

node -v
npm -v

Next, install and configure Poetry:

pip install poetry
poetry --version
poetry config virtualenvs.in-project true

Next, clone the repository:

git clone https://github.com/davidafshepherd/smartcart-v3
cd smartcart-v3

Next, set up the backend:

cd backend
poetry install

Run the backend to verify it is set up:

poetry run uvicorn app.main:app --reload --port 8000

The backend will run at http://127.0.0.1:8000/docs. Press CTRL + C to exit.

Lastly, set up the frontend:

cd ../frontend
npm install

Run the frontend to verify it is set up:

npm run dev

The frontend will run at http://localhost:3000. Press CTRL + C to exit.