// readme

PDAgent (Pocket Desk Agent) - Control Your PC from Anywhere via Telegram

Pocket Desk Agent is a self-hosted Telegram bot that gives you full remote control of your Windows PC from any device. Unlike TeamViewer, AnyDesk, or RDP — it needs no account, no open inbound ports, no router config, and no subscription. It runs entirely on your machine; only Telegram’s message relay and the optional Gemini API touch the internet.

Quick start (about two minutes)

  1. Create a Telegram bot with @BotFather and copy its token (details in Before You Start).
  2. On your Windows PC:
pip install pocket-desk-agent
pdagent
  1. Follow the setup wizard, then message your bot from your phone. Try /screenshot.

Why not TeamViewer, AnyDesk or RDP?

Pocket Desk AgentTeamViewer / AnyDeskRDP
Account or subscriptionNoneRequiredNone
Open inbound ports / router setupNone (outbound only)NoneRequired
Works from any Telegram client✅❌❌
Scheduled and repeating tasks✅❌❌
OCR click-by-text and macros✅❌❌
Natural-language PC control…