realtimex-deeptutor 0.5.0.post3__py3-none-any.whl → 0.5.0.post4__py3-none-any.whl

{realtimex_deeptutor-0.5.0.post3.dist-info → realtimex_deeptutor-0.5.0.post4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: realtimex-deeptutor
-Version: 0.5.0.post3
+Version: 0.5.0.post4
 Summary: RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG
 License: Apache-2.0
 Requires-Python: >=3.10

{realtimex_deeptutor-0.5.0.post3.dist-info → realtimex_deeptutor-0.5.0.post4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 realtimex_deeptutor/__init__.py,sha256=sSfuCLjJa6BnayszcU4azNl_sr1OzuKgLP10BAtdoh8,1567
-realtimex_deeptutor-0.5.0.post3.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+realtimex_deeptutor-0.5.0.post4.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
 scripts/__init__.py,sha256=mxMsCbci-Qon3qWU1JIi93-tYlHAy0NIUbDRmAPVcg0,54
 scripts/audit_prompts.py,sha256=Ltuk7tvsjpKhiobVbYq1volgVFKiVLgSTaE_Is4MGaM,5651
 scripts/check_install.py,sha256=GbApEcDLJ6r0QmYrCVHAFCOK4wolpSLwL3eBRmmD3og,13929
@@ -7,7 +7,7 @@ scripts/generate_roster.py,sha256=COsJ12bvZ5W9TI-wAvKpknKBgHr9uQTvJ_JCz2gVMVo,12
 scripts/install_all.py,sha256=u-A3eLhk1ua_KCjz8WZMkrVNJN6QdYs7NhGOcsm-Mks,23875
 scripts/migrate_kb.py,sha256=uyJgplkJag35rT2RrwSiT37__gpB4TiA0xh5uVcWIa4,19667
 scripts/start.py,sha256=EYbyjryor0DN_WcxQMSkKWCboM9UjMkv61fWhLyv63I,30300
-scripts/start_web.py,sha256=vzn7TiW7g2RNpAKYPQjHVNtOt6G9MxokEnZE_YWfHu4,22980
+scripts/start_web.py,sha256=aZ5nqH-h2F6I_tAsY-_uy56jIS5ZJt8Fsjw0OHjEYGc,29755
 scripts/sync_prompts_from_en.py,sha256=TkBSFilYSwnwo0a3cgRnJ84i02zByAIW12N3ePzBwE8,4677
 src/__init__.py,sha256=UNw3C20mbskiQF3rK3HhjglrG8snhfuiVthc5UsoHX0,1046
 src/agents/__init__.py,sha256=IPhP4RZnCH2kcUDBkdKHO_ciVdyWnuHUCG2flG5Ydcw,885
@@ -150,7 +150,7 @@ src/api/utils/notebook_manager.py,sha256=4zTn_J10BmWlCaCJo3bcNWiWUGgLw4hGR92sfj3
 src/api/utils/progress_broadcaster.py,sha256=u1cfxZ2Rek9tSP9sP1hdQMQkh6Dr_6fhzJjBUvFf-3I,2772
 src/api/utils/task_id_manager.py,sha256=E59dJ2rg-_qY7uACNT3Nmzey0fnpZgfMYerW-8QsaNM,3687
 src/cli/__init__.py,sha256=MQ18rJWUlLlk_keWk7lrCjOYW5c_kDfJr5roKDu5ZT8,269
-src/cli/start.py,sha256=KNQ4ulAB4QCcS39Z5TcYWw4UtTzfEFCJg_yZOtg-Brw,6664
+src/cli/start.py,sha256=g2kYPuynTDCDL66wJ8IUchRLd-ZV8q5-SjAuuZWyYto,6744
 src/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/config/accessors.py,sha256=A06OaUK78MdgLu__6MRcKcVoog1ctDj5fHP4APOyRiI,534
 src/config/constants.py,sha256=C3370U6qkFExKkoNyDDLcf05FIJU0_5MHvpT6mvDQ7A,734
@@ -289,8 +289,8 @@ src/utils/error_utils.py,sha256=ME_9q-DlmxFl-Xvv3ETPZE_iP705x6MXiuAREgWYsjM,2262
 src/utils/json_parser.py,sha256=M_KfrsrNvQPSiFvpKHQV79Aj85_MEcLVc6hnKzvTV58,3243
 src/utils/realtimex.py,sha256=WlGeZ7d-ymXIJ6ZYK2nhjqxArV_7rVHHJLCqaNkcOUw,8648
 src/utils/network/circuit_breaker.py,sha256=BtjogK5R3tG8fuJniS5-PJKZMtwD5P2SkP2JFiQ9sRA,2722
-realtimex_deeptutor-0.5.0.post3.dist-info/METADATA,sha256=cPG-bhP_0bk97uBwQaN9OzVTH9YiVceBLDrNM4_yv8Q,58304
-realtimex_deeptutor-0.5.0.post3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-realtimex_deeptutor-0.5.0.post3.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
-realtimex_deeptutor-0.5.0.post3.dist-info/top_level.txt,sha256=zUAd6V7jDYhdL7bvg2S38YCM-gVhvd36WqkjxrT-02I,32
-realtimex_deeptutor-0.5.0.post3.dist-info/RECORD,,
+realtimex_deeptutor-0.5.0.post4.dist-info/METADATA,sha256=Jjy3Gnux_cDuNru960f4mpCvK3kz1OJWaD7vrd_413k,58304
+realtimex_deeptutor-0.5.0.post4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+realtimex_deeptutor-0.5.0.post4.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
+realtimex_deeptutor-0.5.0.post4.dist-info/top_level.txt,sha256=zUAd6V7jDYhdL7bvg2S38YCM-gVhvd36WqkjxrT-02I,32
+realtimex_deeptutor-0.5.0.post4.dist-info/RECORD,,

scripts/start_web.py

@@ -69,6 +69,194 @@ else:
         return False
 
 
+def check_port_in_use(port: int) -> tuple[bool, int | None]:
+    """
+    Check if a port is in use and return the PID of the process using it.
+
+    Uses connect test to check if something is actually LISTENING on the port,
+    rather than bind test which fails for TIME_WAIT state.
+
+    Args:
+        port: Port number to check
+
+    Returns:
+        Tuple of (is_in_use, pid_or_none)
+    """
+    import socket
+
+    # Use connect test to check if something is actually listening
+    # This avoids false positives from TIME_WAIT state
+    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    sock.settimeout(1)
+    try:
+        result = sock.connect_ex(("localhost", port))
+        if result != 0:
+            # Connection refused = nothing listening = port is free
+            return False, None
+    except (OSError, socket.timeout):
+        # Connection failed = port is free
+        return False, None
+    finally:
+        try:
+            sock.close()
+        except Exception:
+            pass
+
+    # Port is in use (connection succeeded), try to find the PID
+    pid = None
+    try:
+        if os.name == "nt":
+            # Windows: use netstat
+            result = subprocess.run(
+                ["netstat", "-ano"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+            )
+            for line in result.stdout.splitlines():
+                if f":{port}" in line and "LISTENING" in line:
+                    parts = line.split()
+                    if parts:
+                        try:
+                            pid = int(parts[-1])
+                            break
+                        except ValueError:
+                            pass
+        else:
+            # Unix: use lsof
+            result = subprocess.run(
+                ["lsof", "-ti", f":{port}"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+            )
+            if result.returncode == 0 and result.stdout.strip():
+                # May return multiple PIDs, take the first one
+                try:
+                    pid = int(result.stdout.strip().split()[0])
+                except (ValueError, IndexError):
+                    pass
+    except Exception:
+        pass
+
+    return True, pid
+
+
+def kill_process_on_port(port: int, force: bool = False) -> bool:
+    """
+    Kill the process using a specific port.
+
+    Args:
+        port: Port number
+        force: If True, use SIGKILL instead of SIGTERM
+
+    Returns:
+        True if process was killed successfully
+    """
+    in_use, pid = check_port_in_use(port)
+    if not in_use:
+        return True  # Port is free
+
+    if pid is None:
+        print_flush(f"⚠️  Port {port} is in use but couldn't identify the process")
+        return False
+
+    print_flush(f"   Stopping process {pid} on port {port}...")
+
+    try:
+        if os.name == "nt":
+            subprocess.run(["taskkill", "/F", "/PID", str(pid)], check=True, capture_output=True)
+        else:
+            sig = signal.SIGKILL if force else signal.SIGTERM
+            os.kill(pid, sig)
+            # Wait a moment for process to terminate
+            time.sleep(0.5)
+            # Check if still running, force kill if needed
+            if not force:
+                try:
+                    os.kill(pid, 0)  # Check if process exists
+                    os.kill(pid, signal.SIGKILL)
+                    time.sleep(0.3)
+                except ProcessLookupError:
+                    pass  # Process already terminated
+
+        # Verify port is now free
+        time.sleep(0.3)
+        in_use, _ = check_port_in_use(port)
+        if not in_use:
+            print_flush(f"✅ Port {port} is now free")
+            return True
+        else:
+            print_flush(f"⚠️  Port {port} still in use after killing process")
+            return False
+
+    except Exception as e:
+        print_flush(f"❌ Failed to kill process {pid}: {e}")
+        return False
+
+
+def ensure_ports_available(backend_port: int, frontend_port: int, auto_kill: bool = False) -> bool:
+    """
+    Ensure required ports are available, optionally killing existing processes.
+
+    Args:
+        backend_port: Backend port number
+        frontend_port: Frontend port number
+        auto_kill: If True, automatically kill processes using the ports
+
+    Returns:
+        True if all ports are available
+    """
+    ports_to_check = [
+        (backend_port, "Backend"),
+        (frontend_port, "Frontend"),
+    ]
+
+    conflicts = []
+    for port, name in ports_to_check:
+        in_use, pid = check_port_in_use(port)
+        if in_use:
+            conflicts.append((port, name, pid))
+
+    if not conflicts:
+        return True
+
+    print_flush("")
+    print_flush("⚠️  Port conflict detected:")
+    for port, name, pid in conflicts:
+        pid_info = f" (PID: {pid})" if pid else ""
+        print_flush(f"   - {name} port {port} is already in use{pid_info}")
+
+    if auto_kill:
+        print_flush("")
+        print_flush("🔄 AUTO_KILL_PORTS is enabled, cleaning up...")
+        all_freed = True
+        for port, name, _ in conflicts:
+            if not kill_process_on_port(port):
+                all_freed = False
+        return all_freed
+    else:
+        print_flush("")
+        print_flush("💡 To resolve this, you can either:")
+        print_flush("   1. Set AUTO_KILL_PORTS=true to automatically clean up")
+        print_flush("   2. Manually kill the processes:")
+        for port, name, pid in conflicts:
+            if pid:
+                if os.name == "nt":
+                    print_flush(f"      taskkill /F /PID {pid}")
+                else:
+                    print_flush(f"      kill -9 {pid}")
+            else:
+                if os.name == "nt":
+                    print_flush(f"      netstat -ano | findstr :{port}")
+                else:
+                    print_flush(f"      lsof -ti :{port} | xargs kill -9")
+        print_flush("   3. Use different ports via environment variables:")
+        print_flush("      BACKEND_PORT=8002 FRONTEND_PORT=3783 uvx realtimex-deeptutor")
+        print_flush("")
+        return False
+
+
 def terminate_process_tree(process, name="Process", timeout=5):
     """
     Terminate a process and all its children (process group).
@@ -541,6 +729,23 @@ if __name__ == "__main__":
         print_flush(f"⚠️ Warning: Failed to initialize user directories: {e}")
         print_flush("   Continuing anyway...")
 
+    # Check for port conflicts before starting services
+    try:
+        from pathlib import Path
+
+        from src.services.setup import get_ports
+
+        backend_port, frontend_port = get_ports(
+            Path(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+        )
+
+        auto_kill = os.environ.get("AUTO_KILL_PORTS", "").lower() in ("true", "1", "yes")
+        if not ensure_ports_available(backend_port, frontend_port, auto_kill=auto_kill):
+            sys.exit(1)
+    except Exception as e:
+        print_flush(f"⚠️ Warning: Failed to check ports: {e}")
+        print_flush("   Continuing anyway...")
+
     backend = None
     frontend = None
 

src/cli/start.py

@@ -39,6 +39,7 @@ Examples:
 Environment Variables:
   FRONTEND_PORT       Frontend port (default: 3782)
   BACKEND_PORT        Backend port (default: 8001)
+  AUTO_KILL_PORTS     Auto-kill processes using required ports (default: false)
   RTX_APP_ID          RealTimeX App ID (auto-detected)
   API_BASE_URL        Backend API URL (auto-configured)
   LOG_LEVEL           Logging level (DEBUG, INFO, WARNING, ERROR)