🔮 QuantuSight Dashboard

QuantuSight is a comprehensive observability and management dashboard for IBM Quantum jobs. It combines real-time monitoring, machine learning insights, and a drag-and-drop circuit composer into a sleek, modern interface.

🚀 Features

• Real-Time Dashboard: Monitor job status (Running, Queued, Completed) and backend usage live.
• Job Creator: Build quantum circuits visually or upload .qpy files and submit them to IBM Quantum.
• Local Simulator: Test your circuits instanty with a drag-and-drop local simulator.
• ML Insights: Predictive analytics for queue times and error rates (linked external tool).
• System Health: Automatic health checks for IBM Quantum services and API connectivity.
• Secure Auth: IBM Quantum API token validation and checking.

🛠️ Prerequisites

• Python 3.10 or higher
• IBM Quantum Account: You need an API Token from IBM Quantum Platform.

📦 Installation

1. Navigate to the Project Directory

   cd QuantuSight_revamped/backend

2. Set Up a Virtual Environment (Optional but Recommended)

   • Windows (PowerShell):

     python -m venv .venv
     .\.venv\Scripts\Activate.ps1

     (If you get a permission error, run: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process)

   • Mac/Linux:

     python3 -m venv .venv
     source .venv/bin/activate

3. Install Dependencies

   pip install -r requirements.txt

⚙️ Configuration

1. Create a .env file in the backend folder (or edit the existing one).

2. Add your IBM Quantum configuration:

   # .env file content
   IBM_API_TOKEN=your_ibm_quantum_api_token_here
   MONGO_URI=mongodb+srv://... (if using database features)
   APP_SECRET=your_secret_key

   Note: You can also enter/validate your API token directly in the Dashboard Settings UI without editing the file manually.

▶️ Running the Application

1. Start the Flask Server

   python app.py

2. Access the Dashboard Open your browser and navigate to: http://localhost:5000

🧭 Navigation Reference

• DASHBOARD (/dashboard): Main view of your job history and system status.
• HOME (/home): Landing page.
• CREATE JOB (/quantum_jobs): Visual circuit builder for IBM backends.
• LOCAL SIM (/local): Drag-and-drop simulator running locally in your browser.

❓ Troubleshooting

• "No module named...": Ensure you activated the virtual environment and ran pip install -r requirements.txt.
• Jobs not loading: Check the terminal output. If you see 401 Unauthorized, your API token might be invalid or expired. Use the "Settings" gear icon on the dashboard to re-validate it.
• Permission Denied (Windows): See the "Set-ExecutionPolicy" command in the Installation section.

---

Built for the Amaravati Hackathon 2025.