Heracles – Level Up Your Maintenance

Heracles is a modern, Windows-native system maintenance toolkit built for power users and IT professionals.
It delivers diagnostics, optimization, and security management through a real-time Next.js interface, backed by tightly integrated PowerShell automation.

Note: Heracles is currently in public beta. All core features are stable, but enhancements and refinements are actively ongoing.
Contributions, bug reports, and feature suggestions are highly appreciated.

Features

Heracles provides a comprehensive suite of tools for monitoring, diagnosing, and optimizing Windows systems.

🖥️ System Monitoring

• Real-time CPU, memory, disk, and battery statistics
• CPU load, thread count, virtualization status, speed monitoring
• Thermal data (temperature sensors, if supported)
• Uptime tracking with reboot suggestions

🚀 Performance Optimization

• Clean temporary files (AppData, Temp, %SystemTemp%)
• Flush DNS cache
• Restart Windows Explorer instantly
• Adjust processor power states (AC/DC performance configuration)
• Empty Recycle Bin via automation

🔐 Security & Stability

• Quick Windows Defender scan integration
• Display recent scan results and threat count
• System security signal overview (UAC, RDP, Secure Boot, etc.)

⚙️ System Control

• Startup program manager (enable/disable entries from registry & folders)
• Windows Update status checker
• Battery health and runtime insights (for portable devices)

📡 Backend Integration

• PowerShell automation for all critical actions
• Next.js API routes with Promisified PowerShell execution
• Polling & scheduling support for key metrics

💡 Developer Friendly

• Built using Next.js App Router, Tailwind CSS, and ShadCN UI
• Modular and extensible architecture
• Clean, documented codebase with separation of concerns

Getting Started

To run Heracles on your Windows system, you’ll need to install dependencies and launch the app in development or production mode.

⚠️ Heracles requires Windows 10 or higher with administrative privileges to execute system-level PowerShell scripts.

Prerequisites

• Node.js >= 18.x
• PowerShell 5.1+
• Git (optional, for cloning the repository)

Installation

Follow these steps to install and run Heracles on your Windows machine:

---

• Please clone the repo

  git clone https://github.com/dave1725/heracles.git

• Get into the repo

  cd heracles

• Install dependencies

  npm install

• Run terminal as Administrator

  Heracles requires elevated privileges to execute PowerShell scripts and interact with system-level resources

  Make sure to open your terminal (CMD or PowerShell) as Administrator for proper execution.

• Next, please build the application

  npm run build

• Next, start your production server

  npm start   

The application will now be accessible at: http://localhost:3000

Author(s)

This project is developed and maintained by:

• Dave – @dave1725
  Lead Developer, PowerShell Integration, UI/UX Design, System Architecture

---

If you’d like to contribute to the project, please check the Contributing Guide and open a pull request or issue.

License

This project is open-source and licensed under GNU. Feel free to contribute and be part of the digital evolution.