SwiftOps-Executable

SwiftOps is built using various technologies (Node.js, Python, PostgreSQL, Redis), it cannot be natively compiled into a single .exe file without bloating it with huge runtime environments. Instead, We've built a Docker Launcher.

This approach provides a clean, single .exe file that automatically handles starting up all the services via Docker and opens the application in your browser.

Prerequisites

Before running the launcher, please ensure the following is installed on your machine:

• Docker Desktop: Download here (Make sure the Docker engine is running).

How to Run

1. Make sure this SwiftOps-Executable folder is located in the root of the main SwiftOps project directory (it needs to be adjacent to the core, frontend, etc. folders).
2. Simply double-click on SwiftOps_Launcher.exe (found in the dist folder after building).
3. A terminal will open and automatically run docker compose up -d --build.
4. Once all 6 containers have started successfully, your default web browser will automatically open to http://localhost:8080.

How to Build the Executable (For Developers)

If you are modifying the Python launcher script and need to recompile the .exe:

1. Ensure you have Python installed on your Windows machine.
2. Double-click the build_exe.bat script.
3. This will automatically install PyInstaller and compile launcher.py into a standalone .exe.
4. The newly generated executable will be placed in the dist/ folder.

Architecture Orchestration

The docker-compose.yml file in this folder connects the following services:

• postgres: Database for the Core API (Port 5432)
• redis: Caching mechanism (Port 6379)
• core: NestJS Backend API (Mapped to Port 3004)
• logginglayer: NestJS Microservice (Mapped to Port 3001)
• fault-prediction: Python/FastAPI Machine Learning Service (Mapped to Port 8000)
• frontend: Next.js Web Interface (Mapped to Port 8080)

To shut down the services manually, open a terminal in this directory and run:

docker compose down