Windows:
python -m venv .venv
.venv\Scripts\Activate.ps1macOS / Linux:
python3 -m venv .venv
source .venv/bin/activatepip install -r requirements.txtIf you get email_validator errors:
pip install email-validatorCreate a .env file in the project root:
DATABASE_URL=mysql+pymysql://root:<YOUR_PASSWORD>@localhost:3306/resume_system
JWT_SECRET=super_secret_key
JWT_ALGORITHM=HS256
💡 Make sure the database exists! If not, create it manually in MySQL:
CREATE DATABASE resume_system CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;uvicorn app.main:app --reloadVisit http://127.0.0.1:8000/docs for Swagger UI.
- Don’t push your
.venv— it’s in.gitignorefor a reason. - Don’t commit
.enveither — that’s how you leak passwords. - Use
pip freeze > requirements.txtif you install new packages. - Always run
git pullbefore you start editing.
| Error | Cause | Fix |
|---|---|---|
Unknown database 'resume_system' |
You didn’t create the DB | CREATE DATABASE resume_system; |
email-validator not installed |
Missing dependency | pip install email-validator |
401 Unauthorized |
Wrong password or not registered | Register first |
ModuleNotFoundError: No module named 'app' |
You ran from wrong directory | Run uvicorn app.main:app --reload from project root |