Skip to content

STARTUP_GUIDE.md

Latest commit

 

History

History
77 lines (57 loc) · 2.12 KB

STARTUP_GUIDE.md

File metadata and controls

77 lines (57 loc) · 2.12 KB

🚀 Portfolio Optimization - Server Startup Guide

✅ Issues Fixed

  • ✅ bcrypt compatibility issue resolved
  • ✅ uvicorn server configuration updated
  • ✅ Python vs python3 command issue resolved
  • ✅ All dependencies installed and compatible

🎯 How to Start Your Portfolio Optimization Site

Option 1: Simple Bash Script (Recommended)

./start.sh

This is the easiest method. It will:

Option 2: Python Script (Alternative)

python3 start_server.py

Option 3: Backend Only (For Testing)

python3 start_backend.py

Option 4: Manual Start (If You Prefer Control)

# Terminal 1 - Backend API
cd backend
source venv/bin/activate
uvicorn api_server:app --host 0.0.0.0 --port 8000 --reload

# Terminal 2 - Frontend
cd frontend/frontend
npm run dev

🌐 Access Your Application

Once started, you can access:

🐛 If You Still Have Issues

  1. Make sure you're in the right directory: You should be in the portfolio-optimization folder
  2. Check Python version: Run python3 --version (should be 3.x)
  3. Check Node.js: Run npm --version (should be installed)
  4. Virtual environment: The backend virtual environment should be in backend/venv/

📊 What's Working Now

  • ✅ Backend API server starts without bcrypt errors
  • ✅ All authentication endpoints functional
  • ✅ Portfolio optimization endpoints ready
  • ✅ Data fetching capabilities restored
  • ✅ Frontend can connect to backend API

🔧 Technical Details

  • Fixed bcrypt version compatibility (downgraded to 4.0.1)
  • Updated uvicorn to use proper app import string
  • All Python dependencies properly installed in virtual environment
  • CORS configured for frontend-backend communication

Need help? The test confirmed everything is working! Just run ./start.sh and you should be good to go! 🎉