Evil Winrm Py

evil-winrm-py

evil-winrm-py is a python-based tool for executing commands on remote Windows machines using the WinRM (Windows Remote Management) protocol. It provides an interactive shell with enhanced features like file upload/download with progress and checksum verification, tab-completion of local/remote paths and PowerShell cmdlets, loading and running PowerShell scripts, in-memory execution of DLLs and EXEs, command history, and colorized output. It can also run as an MCP server, exposing WinRM sessions as tools for MCP-compatible clients. It supports various authentication methods including NTLM, Pass-the-Hash, Certificate, and Kerberos. skip to installation

[!NOTE] This tool is designed strictly for educational, ethical use, and authorized penetration testing. Always ensure you have explicit authorization before accessing any system. Unauthorized access or misuse of this tool is both illegal and unethical.

Motivation

The original evil-winrm is written in Ruby, which can be a hurdle for some users. Rewriting it in Python makes it more accessible and easier to use, while also allowing us to leverage Python’s rich ecosystem for added features and flexibility.

I also wanted to learn more about winrm and its internals, so this project will also serve as a learning experience for me.

Features

• Execute commands on remote Windows machines via an interactive shell.
• Download files from the remote host to the local machine.
• Upload files from the local machine to the remote host.
• Progress bar for file transfers with speed and time estimation.
• Stable and reliable file transfer including support for large files with MD5 checksum verification.
• Auto-complete local and remote file paths (even those with spaces) with Tab completion.
• Auto-complete PowerShell cmdlets/helpers with Tab completion.
• Load PowerShell functions from local scripts into the interactive shell.
• Run local PowerShell scripts on the remote host.
• Load local DLLs (in-memory) as PowerShell modules on the remote host.
• Upload and execute local EXEs (in-memory) on the remote host.
• List the running services (except system services) on the remote host.
• Optional MCP server mode to expose WinRM login/execute/logout as tools for MCP clients, with support for multiple concurrent sessions. 🆕
• Enable logging and debugging for better traceability.
• Navigate command history using up/down arrow keys.
• Display colorized output for improved readability.
• Lightweight and Python-based for ease of use.
• Keyboard Interrupt (Ctrl+C / Ctrl+D) support to terminate long-running commands gracefully.

Includes support for:

• NTLM authentication.
• Pass-the-Hash authentication.
• Certificate authentication.
• Kerberos authentication with custom SPN prefix and hostname options.
• SSL to secure communication with the remote host.
• custom WSMan URIs.
• custom user agent for the WinRM client.
• connecting to Just Enough Administration (JEA) session configurations. 🆕

Detailed documentation can be found in the docs directory.

Installation

Installation of Kerberos prerequisites on Linux

sudo apt install gcc python3-dev libkrb5-dev krb5-pkinit
# Optional: krb5-user

Install evil-winrm-py