Repository for HackHer 2026 project Seamstress! Perfect. Here is a single clean copy-paste block you can drop directly into your README.md.

• Python 3.10+ (check with python3 --version)
• pip
• Git

git clone <repo-url>
cd resProject

From the project root:

python3 -m venv .venv

Activate it:

source .venv/bin/activate

.venv\Scripts\Activate.ps1

You should now see (.venv) in your terminal.

From the project root:

pip install -r backend/requirements.txt

(Optional but recommended)

pip install --upgrade pip

These are required for DigitalOcean Spaces file storage. For Gemini + cross-origin frontend requests, also set:

• GEMINI_API_KEY=<your key>
• GEMINI_MODEL=gemini-2.5-flash (optional)
• CORS_ALLOWED_ORIGINS=http://localhost:5173,http://127.0.0.1:5173,https://seamstress-m6lai.ondigitalocean.app

cd backend
uvicorn app.main:app --reload --port 8000

You should see:

Uvicorn running on http://127.0.0.1:8000

Open in your browser:

Swagger UI:

http://127.0.0.1:8000/docs

Health check:

http://127.0.0.1:8000/health

Press:

CTRL + C

ModuleNotFoundError: app

• Make sure you cd backend
• Then run uvicorn app.main:app --reload --port 8000

Could not open requirements.txt

• Run: pip install -r backend/requirements.txt from the project root

Virtual environment not activated

• Run: source .venv/bin/activate (Mac/Linux)
• Or: .venv\Scripts\Activate.ps1 (Windows)

FRONT END FRONT END

cd frontend

npm install

if .env.example does not exist in frontend folder (NOT IN SRC) create it and just add this line VITE_API_BASE_URL=https://seamstress-m6lai.ondigitalocean.app

npm run dev

open the url http://localhost:5173/