🔍 Troubleshooting

Common issues, useful commands, and a final checklist.

🛠️Troubleshooting

Port Already in Use

uvicorn main:app --port 8001 --reload

Module Not Found Error

# Ensure virtual environment is activated
# Then reinstall dependencies
pip install -r requirements.txt

Permission Denied

# Windows: Run as Administrator
# Linux/Mac: Use sudo if necessary
sudo uvicorn main:app --reload

Environment Variables Not Loading

Make sure your .env file is in the root directory and properly formatted (no spaces around =).

💻Useful Commands

Deactivate Virtual Environment
deactivate
Update Dependencies
pip install --upgrade -r requirements.txt
View Installed Packages
pip list
Stop the Server

Press Ctrl + C in the terminal

Final Checklist

  • ☑️ Python installed and verified
  • ☑️ Application downloaded and extracted
  • ☑️ Virtual environment created and activated
  • ☑️ Dependencies installed from requirements.txt
  • ☑️ .env configured (username, password, and API key if needed)
  • ☑️ Application running successfully
  • ☑️ Accessed application in browser