Star on GitHub
AI-Powered Remote Management

Remote Control.
Elevated by Agentic AI.

Monitor, wake, and control your Windows & Linux client machines directly from Telegram. Bypass NATs and firewalls securely using modern WebSocket tunnels, with a smart AI assistant executing tasks on your system.

Get the Code Read Setup Guide
Telegram Simulator
🤖 windOS Assist Bot is ready. Type a command to start.
/greet
Greetings, winmastt!, Server and client status:
🟢 Server [Online] | 🟢 GamingPC [Online]
🌦️ Weather: 18°C, Partly Cloudy in Kyiv.
📅 Date: 2026-05-23 | ⏰ Time: 01:22:00 
      _.-'''''''-._     windOS Assist Info
    .'  .---.      '.   ------------------
   /   (     )       \  Server CPU: AMD Ryzen 5
   |  (  .---'       |  Client CPU: Intel i7-12700K
   \   (________)    /  Client GPU: NVIDIA RTX 4070
    '.             .'   Uptime: 1 day, 4 hours
      '-._______.-'     Uptime Server: 5 days

Engineered for Power & Simplicity

Everything you need to orchestrate your hardware from anywhere in the world.

Zero Port Forwarding

Clients establish outward WebSocket tunnels to the server. Works instantly behind double NATs, home routers, and strict carrier firewalls.

Agentic AI Assistant

Integrates Gemini, OpenAI, or local Ollama endpoints. The AI is aware of system states and calls tools (screenshots, shell commands) autonomously to accomplish tasks.

Wake-on-LAN Recovery

Trigger Wake-on-LAN magic packets from the Telegram chat to power on client PCs. Includes client-to-server WoL recovery if the server goes offline.

Decentralized Failover

If the server goes down, the client launches a local fallback Telegram bot. Command your machine directly without losing connection.

Interactive Shell Tunnels

Open a persistent, interactive command prompt (`cmd.exe` or `bash`) directly inside Telegram. Run commands, check output, and manage directories in real-time.

Jam-Proof Telemetry

Uses stable IP-based geolocation and provides weather details (via Open-Meteo) even in GPS-jammed regions like Ukraine.

Advanced Secure Routing

Unlike traditional VNC or remote desktop services that expose open ports to the internet, windOS Assist secures communication by utilizing a centralized secure WebSocket bridge.

01

Client Handshake

On boot, the client gathers hardware and location stats, connects to the server, and authorizes using a pre-shared token.

02

Secure Telegram Tunnel

Commands from your authorized Telegram account are verified by Chat ID and routed directly through the open WebSocket tunnel.

03

Local Action Execution

The client process executes the shell command or takes screen captures, streaming the resulting console blocks back to Telegram instantly.

Server (Linux)
Client (Win/Linux)
Telegram Bot

Test the Console

Interact with the terminal emulator below. Type standard client commands and see responses.

windOS-Assist Console (winmastt@windos-client)

Welcome to windOS Assist interactive web shell.

Type 'help' to see list of valid commands.

winmastt@windos-client:~$

Deploy windOS Assist

Get up and running in less than 5 minutes using the unified setup wizard.

Step 1: Get the Wizard

Clone the repository on your client PC (which can be your Windows laptop or desktop):

git clone https://github.com/winmasttdev/windOS-Assist.git
cd windOS-Assist

Step 2: Run Setup

Start the interactive installer wizard. It will guide you through connecting to your Linux server and setting up startup hooks:

python setup.py

The wizard automatically configures background daemons (using systemd on Linux and Task Scheduler with hidden VBS wrappers on Windows).