Installation¶

Requirements¶

System Requirements

Python 3.11 or higher
Windows RDP server with Network Level Authentication (NLA) enabled

Install with pip¶

From PyPI (Recommended) With pipx (Isolated)

pip install simple-rdp

This installs Simple RDP with the native Rust extension for high-performance RLE bitmap decompression, providing up to 100x faster screenshot performance.

pipx install simple-rdp

Use pipx for a globally available, isolated installation.

Install from source¶

Building from source

Building from source requires the Rust toolchain.

Prerequisites¶

Install Rust from rustup.rs
Install maturin: pip install maturin

Using maturin (recommended)¶

git clone https://github.com/abi-jey/simple-rdp.git
cd simple-rdp
maturin develop --release

Using pip with build¶

git clone https://github.com/abi-jey/simple-rdp.git
cd simple-rdp
pip install -e .

Verify Installation¶

import simple_rdp
print(simple_rdp.__version__)

Performance¶

Metric	Performance
Screenshot FPS	~30 FPS
Event Loop Usage	~10%

Dependencies¶

Simple RDP depends on the following packages (automatically installed):

pyspnego: NTLM/Kerberos authentication
pyasn1: ASN.1 encoding/decoding
pillow: Image processing
asn1crypto: Additional ASN.1 support
python-dotenv: Environment variable loading

Optional: MCP Server¶

To use Simple RDP with AI agents via the Model Context Protocol:

pip install simple-rdp[mcp]

MCP Integration

The MCP server allows LLM agents like Claude to interact with remote Windows desktops. See the MCP Server guide for usage details.