QUICKSTART.md

🚀 Quick Start Guide

Get Started in 3 Steps

1️⃣ Install Dependencies

Run the setup script:

setup.bat

Wait for installation to complete (takes 1-2 minutes).

2️⃣ Launch the System

Run the launcher:

run_all.bat

This will open 3 terminal windows automatically.

3️⃣ Access the Applications

Open your browser and visit:

• OTP Generator: http://localhost:8501
• OTP Verifier: http://localhost:8502
• API Docs: http://localhost:8000/docs

🎯 What to Do Next

1. On Generator page (8501):

   • See the current 6-digit OTP
   • Adjust validity slider (15-120 seconds) in sidebar
   • Click "Regenerate OTP" button to generate new OTP manually
   • View live mathematical calculations

2. On Verifier page (8502):

   • Enter the OTP from generator
   • Click "Verify OTP"
   • Explore the mathematical formula section
   • See all variables and time-slice index live

🌐 Network Access (Optional)

To access from other devices on your network:

1. Find your IP address:

   ipconfig

   Look for "IPv4 Address" (e.g., 192.168.1.100)

2. Update config.py:

   api_url = "http://192.168.1.100:8000"

3. Access from other devices:

   • Generator: http://192.168.1.100:8501
   • Verifier: http://192.168.1.100:8502

❓ Having Issues?

• Make sure Python 3.10+ is installed
• Check that ports 8000, 8501, 8502 are not in use
• See full README.md for detailed troubleshooting

📚 Features

• ✅ Default 45-second OTP validity
• ✅ Custom validity (15-120 seconds slider)
• ✅ Manual OTP regeneration
• ✅ Live mathematical formula display
• ✅ Real-time variable values
• ✅ Current time-slice index
• ✅ Network shareable

---

Need more details? Read the full README.md