Quick Start
===========

Start a Single Server
---------------------

Start a specific quantum system server:

.. code-block:: bash

   # Start the Superconducting quantum server (default port 7000)
   python main.py --system superconducting

   # Start the Ion Trap quantum server (default port 7001)
   python main.py --system ion_trap

   # Start the Neutral Atom quantum server (default port 7002)
   python main.py --system neutral_atom

   # Start the Photonic quantum server (default port 7003)
   python main.py --system photonic

Start All Servers
-----------------

Simultaneously start all four quantum system servers:

.. code-block:: bash

   python main.py --all

Start Server (Automatically Includes Publish Server)
----------------------------------------------------

When starting a server, both the Router server and the Publish server will start automatically:

.. code-block:: bash

   python main.py --system superconducting

**Example Output:**

::

   ============================================================
   Starting superconducting Quantum Simulation Server
   ============================================================

   superconducting server is running
     - Router Port: 7000
     - Pub Port: 8000
     - Bind Address: 0.0.0.0
     - Log Level: INFO
     - Thread Pool Size: 4
     - Max Queue Size: 1000

   Press Ctrl+C to stop server % 

Custom Configuration
--------------------

.. code-block:: bash

   # Custom port (only affects the router port)
   python main.py --system superconducting --port 7005

   # Custom bind address
   python main.py --system superconducting --bind-address 192.168.1.100

   # Set log level
   python main.py --system superconducting --log-level DEBUG

Command Line Arguments Description
----------------------------------

::

   --system {superconducting,ion_trap,neutral_atom,photonic}
                            The type of quantum system to simulate
   --all                    Start all quantum system servers
   --port PORT              Override the default port
   --log-level {DEBUG,INFO,WARNING,ERROR}
                            Set the log level (default: INFO) % 
   --bind-address ADDRESS   Bind address (default: *)