Product Lens is a competitive intelligence tool that helps teams analyze competitors across pricing, hiring, marketing, and product signals to separate real threats from noise.

IMPORTANT: We left out the access keys for safety reasons, therefore the project will not be fully functional.

The project is divided into two main directories:

• /backend: Contains the FastAPI backend that powers the business logic and serves data to the frontend.
• /frontend: Contains the React frontend where users can interact with the system via a clean web interface.

• Python 3.12+
• Node.js 22+

The backend is built with FastAPI and runs on Python. To get started, you’ll set up a Python environment, install the required dependencies, and run the server using uv (a fast Python package runner).

# change directory into 'backend'
cd backend

# create a new virtual environment named '.venv'
python -m venv .venv

# activate the environment (Linux/Mac)
. ./.venv/bin/activate

# install backend dependencies
pip install -r requirements.txt

# start the development server
uvicorn src.main:app --reload --port 8000

The backend will now be running at: http://127.0.0.1:8000

The frontend is built with React and bundled with Vite for fast development. To get started, you’ll install the Node.js dependencies and run the development server, which will issue requests to the FastAPI backend.

# change directory into 'frontend'
cd frontend

# install all Node.js/React dependencies
npm install

# run the React development server (via Vite)
npm run dev