lamda

# **FIRERPA Android** ｜ AI-संचालित स्वचालन

<img src="https://raw.githubusercontent.com/firerpa/lamda/HEAD/image/logo.svg" alt="FIRERPA" width="200" align="right" />

<p>
<img src="https://img.shields.io/badge/python-3.6+-blue.svg?logo=python&amp;labelColor=yellow" />
<img src="https://img.shields.io/badge/android-6.0+-blue.svg?logo=android&amp;labelColor=white" />
<img src="https://img.shields.io/badge/root/non--root--mode-green.svg?logo=android&amp;labelColor=black" />
<img src="https://img.shields.io/badge/Built--in%20MCP-000.svg?logo=anthropic&amp;labelColor=black" />
</p>

<h6>एक ऑल-इन-वन Android स्वचालन ढांचा जो डिवाइस-स्थित सेवाओं, AI-तैयार एजेंटों और विस्तार योग्य टूल आह्वान को जोड़ता है।</h6>

<p align="left"><a href="https://device-farm.com/docs/en/">दस्तावेज़</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">QQ समूह</a> | <a href="https://github.com/firerpa/skills">SKILLS</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="https://github.com/firerpa/lamda/blob/10/README.zh.md">中文版本</a></p>

FIRERPA एक **ऑल-इन-वन Android डिवाइस नियंत्रण प्लेटफ़ॉर्म** है। सर्वर सीधे डिवाइस पर चलता है जिसमें **कोई अतिरिक्त रनटाइम निर्भरता नहीं** होती; यह **Android की कई पीढ़ियों का समर्थन** करता है और **रूट के साथ या बिना रूट** काम करता है। PC पक्ष पर, Python क्लाइंट लाइब्रेरी एक ही सेवा और API के माध्यम से UI स्वचालन, दूरस्थ संचालन, ट्रैफ़िक कैप्चर, Hook-आधारित रिवर्स इंजीनियरिंग, नेटवर्क प्रॉक्सीिंग, वितरित नेटवर्किंग, AI एजेंट और **MCP** को व्यवस्थित करती है। Appium, mitmproxy, frida-server, adb, uiautomator2 और तदर्थ स्क्रिप्ट्स व ऑप्स टूल्स को जोड़ने की तुलना में, FIRERPA **क्षमताओं का एक स्रोत, एकीकृत कॉन्फ़िगरेशन, जुड़े हुए कार्यप्रवाह और मल्टी-डिवाइस, दीर्घकालिक, उत्पादन उपयोग के लिए निर्मित स्टैक** प्रदान करता है।

## रिमोट डेस्कटॉप और लाइव स्ट्रीमिंग

FIRERPA एक ब्राउज़र-आधारित रिमोट डेस्कटॉप प्रदान करता है: समर्पित PC क्लाइंट स्थापित किए बिना, LAN या नेटवर्कों के पार, डिवाइस को वास्तविक समय में देखें और नियंत्रित करें। स्ट्रीमिंग सॉफ़्टवेयर और हार्डवेयर एन्कोडिंग बैकएंड के साथ **MJPEG** और **H.264** दोनों का समर्थन करती है। फ़्रेम दर (60fps तक), रिज़ॉल्यूशन स्केल, बिटरेट और गुणवत्ता को डिवाइस क्षमता और नेटवर्क स्थितियों के अनुसार समायोजित किया जा सकता है—जिससे बैंडविड्थ कम होती है और कमज़ोर कड़ियों पर सुगमता बढ़ती है। **WebRTC** का भी समर्थन है, जिसमें सार्वजनिक या क्रॉस-क्षेत्रीय सेटअपों में बेहतर NAT ट्रैवर्सल और कम एंड-टू-एंड विलंबता के लिए कॉन्फ़िगर करने योग्य STUN/TURN सर्वर शामिल हैं।

रिमोट डेस्कटॉप सहयोगी डीबगिंग, डेमो और प्रशिक्षण के लिए **मल्टी-यूज़र समवर्ती पहुँच** का समर्थन करता है। **द्विदिश क्लिपबोर्ड** साझाकरण और **लाइव ऑडियो** (Android 10+) शामिल हैं, साथ ही एक एकीकृत टर्मिनल, ड्रैग-एंड-ड्रॉप अपलोड और ब्राउज़र-आधारित फ़ाइल ब्राउज़िंग व डाउनलोड—सब एक ही पोर्ट पर। अंतर्निहित **विज़ुअल लेआउट निरीक्षण** तत्वों को हाइलाइट करता है, Tab नेविगेशन का समर्थन करता है, निर्देशांक और RGB मान दिखाता है, और XML लेआउट ट्री निर्यात करता है ताकि आप उसी UI में सेलेक्टर और स्वचालन तर्क को मान्य कर सकें, जिससे स्क्रीन से स्क्रिप्ट तक का चक्र छोटा हो जाता है।

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/251d9eed35540aadebab75dec6f3a59aaeb7c4b5f93ee39e8f74dcb8b0cfa68d.gif" alt="demo" width="100%">
</p>

रिमोट डेस्कटॉप और RPC **एंड-टू-एंड TLS** और सेवा-प्रमाणपत्र अभिगम नियंत्रण का समर्थन करते हैं, सार्वजनिक नेटवर्क पर जोखिम कम करने के लिए वैकल्पिक कस्टम WebUI लॉगिन पासवर्ड के साथ। रिमोट डेस्कटॉप क्षमताओं को WebSocket (लाइव वीडियो, टच, टर्मिनल, कुंजियाँ, आदि) पर आपके अपने वेब ऐप्स में भी एम्बेड किया जा सकता है, जिसमें क्रॉस-ओरिजिन एकीकरण के लिए `allow_origin` शामिल है—वास्तविक-डिवाइस नियंत्रण को उत्पाद रूप देने के लिए उपयुक्त।

## UI स्वचालन

FIRERPA एक पूर्ण सेलेक्टर-आधारित स्वचालन प्रणाली प्रदान करता है: text, resourceId, description, scrollable और अन्य सामान्य मैचर्स, साथ ही डुप्लिकेट तत्वों, गहरे पदानुक्रमों या विशिष्ट विशेषताओं के बिना नियंत्रणों के लिए **child / sibling** चेनिंग। तत्व स्तर पर: स्क्रीनशॉट, प्रकट/अदृश्य होने की प्रतीक्षा, कोने/केंद्र निर्देशांक, अस्तित्व जाँच, Unicode इनपुट, चरणबद्ध स्वाइप, फ्लिंग स्क्रॉलिंग, अंत तक स्क्रॉल, और बहुत कुछ। यह Android 8.0+ पर **अन्य एक्सेसिबिलिटी सेवाओं के साथ सह-अस्तित्व** में रह सकता है और हाइब्रिड ऐप्स के लिए WebView नोड खोज में सुधार करता है।

**UI Watcher** वास्तविक समय में UI परिवर्तनों को सुनता है और स्थितियाँ मेल खाने पर क्लिक, कुंजी इवेंट या काउंटर चलाता है—समझौतों, अपडेट संकेतों, विज्ञापनों और अन्य व्यवधानों को स्वतः खारिज करने के लिए उपयोगी। कई सेलेक्टर स्थितियाँ और प्रति-इवेंट सक्षम/अक्षम समर्थित हैं; क्षणिक स्क्रीनों की गणना की जा सकती है।

**Virtual Display** एक विभेदक है: डिवाइस पर पृथक पृष्ठभूमि डिस्प्ले बनाएं और **मुख्य स्क्रीन को प्रभावित किए बिना** वहाँ ऐप्स और स्वचालन चलाएं—जैसे, फ़ोन का सामान्य रूप से उपयोग करते समय वर्चुअल डिस्प्ले पर स्वतः-उत्तर। वर्चुअल-डिस्प्ले API मुख्य डिवाइस API (`d.xxx` → `vd.xxx`) का दर्पण है; Watchers को वर्चुअल डिस्प्ले तक सीमित किया जा सकता है। WebUI रिमोट डेस्कटॉप में **मल्टी-डिस्प्ले दृश्य और स्विचिंग** का समर्थन करता है—पृष्ठभूमि कार्यों, समानांतर कार्य और मानव-इन-द-लूप के साथ मशीन स्वचालन के लिए आदर्श।

मानक व्यू ट्री के बिना दृश्यों (गेम, कस्टम-चित्रित UI) के लिए, FIRERPA **OCR** और **छवि मिलान** प्रदान करता है। OCR paddleocr, easyocr और कस्टम HTTP बैकएंड का समर्थन करता है; क्लस्टरों में, हर PC पर मॉडल लोड करने के बजाय पहचान केंद्रीय रूप से चल सकती है, GPU त्वरण और लचीले टेक्स्ट मिलान के साथ। छवि मिलान **डिवाइस पर** चलता है (टेम्पलेट या SIFT), बिना PC संसाधनों की खपत के; SIFT घूर्णन, स्केल और प्रकाश के प्रति मज़बूत है। **मल्टी-टच** जटिल जेस्चर और दबाव के लिए रिकॉर्डिंग, रीप्ले, प्रोग्रामेटिक निर्माण और बाइनरी दृढ़ता का समर्थन करता है।

वास्तुकला की दृष्टि से, FIRERPA क्लाइंट/सर्वर मॉडल का उपयोग करता है—AutoJS जैसे ऑन-डिवाइस स्क्रिप्ट रनरों की तुलना में **केंद्रीकृत शेड्यूलिंग, वर्ज़निंग और फ्लीट नियंत्रण** के लिए बेहतर; Appium से हल्का; **मल्टी-डिवाइस परिदृश्यों में uiautomator2 से अधिक स्थिर**। दस्तावेज़ इसे सामान्य Android स्वचालन स्टैकों के **कार्यात्मक सुपरसेट** के रूप में प्रस्तुत करते हैं—स्वचालन, कैप्चर, Hook और ऑप्स को एक ही प्लेटफ़ॉर्म पर कोड में जोड़ा जा सकता है, बिना टूल बदले।

## पैकेट कैप्चर और MITM

FIRERPA **एक-क्लिक MITM कैप्चर** प्रदान करता है: स्वचालित सिस्टम रूट CA स्थापना, प्रॉक्सी सेटअप, Android संस्करण अंतरों का प्रबंधन, और बाहर निकलने पर स्वचालित नेटवर्क पुनर्स्थापन—कोई मैनुअल प्रमाणपत्र या प्रॉक्सी टॉगलिंग नहीं। वैश्विक कैप्चर, प्रति-पैकेज कैप्चर, लाइव अनुरोध/प्रतिक्रिया संपादन, साझा mitmweb और **अंतर्राष्ट्रीय ट्रैफ़िक** के लिए अपस्ट्रीम HTTP प्रॉक्सी समर्थित हैं। अंतर्निहित **QUIC डाउनग्रेड** QUIC हस्तक्षेप को कम करता है। कैप्चर तब भी काम करता है जब PC और डिवाइस केवल एक ही FIRERPA पोर्ट साझा करते हैं (जैसे ADB connect या frp फ़ॉरवर्डिंग)।

एक-क्लिक स्क्रिप्ट्स के अलावा, MITM पूरी तरह **API-संचालित** है: mitmproxy, Fiddler, Charles आदि के साथ संगत सिस्टम CA स्थापित/अनइंस्टॉल करें; UI चरणों और Frida हुक्स के साथ स्वचालन पाइपलाइनों में कैप्चर एम्बेड करें। Python इंस्टॉलेशन के बिना एक Windows **startmitm.exe** उपलब्ध है।

## नेटवर्क, प्रॉक्सी और कनेक्टिविटी

डिवाइस पर, FIRERPA पूर्ण प्रॉक्सी समर्थन प्रदान करता है: **HTTP / HTTPS / SOCKS5 / Shadowsocks** (कई सिफर), प्रति-ऐप प्रॉक्सी (मल्टी-यूज़र क्लोन सहित), DNS प्रॉक्सी, UDP प्रॉक्सी, LAN बायपास, OpenVPN के साथ सह-अस्तित्व, और स्टार्टअप पर कॉन्फ़िगर किए गए प्रॉक्सी से **ऑटो-कनेक्ट**। जटिल नेटवर्कों के लिए प्रॉक्सी **IPv6 और UDP** का समर्थन करते हैं।

**डिवाइस HTTP ब्रिज प्रॉक्सी (tunnel2)** रिवर्स-प्रॉक्सी क्षमता प्रदान करता है: अपने PC या ब्राउज़र HTTP प्रॉक्सी को फ़ोन की ओर इंगित करें और ट्रैफ़िक फ़ोन के नेटवर्क एग्रेस के माध्यम से आगे भेजा जाता है; आउटबाउंड IP फ़ोन से मेल खाता है। एग्रेस इंटरफ़ेस के रूप में Wi‑Fi या सेलुलर (rmnet) चुना जा सकता है—संयुक्त डीबगिंग, अंतर्राष्ट्रीय ऐप्स और मल्टी-डिवाइस IP पूल के लिए उपयोगी।

एक अंतर्निहित **OpenVPN क्लाइंट** सिस्टम प्रॉक्सी के साथ प्रमाणपत्र, उपयोगकर्ता-नाम/पासवर्ड और मिश्रित प्रमाणीकरण का समर्थन करता है; एक **OpenVPN Docker छवि** और कॉन्फ़िग जनरेटर डिवाइस-पक्ष कोड और ऑटोस्टार्ट सेटिंग्स उत्पन्न करते हैं। एक अंतर्निहित **frp क्लाइंट** एन्क्रिप्शन और TLS के साथ `fwd.*` के माध्यम से डिवाइस सेवाओं को सार्वजनिक सर्वर तक अग्रेषित करता है।

**mDNS डिस्कवरी** LAN फ्लीट खोज के लिए वैकल्पिक TXT मेटाडेटा (मॉडल, ABI, डिवाइस ID) के साथ, रिमोट डेस्कटॉप और अन्य सेवाओं तक `{device_id}.local` पहुँच सक्षम बनाती है।

## Frida और रिवर्स इंजीनियरिंग

FIRERPA **नवीनतम Frida को बंडल** करता है—कोई अलग frida-server नहीं। रिमोट डेस्कटॉप टर्मिनल से `-U`, `-H` आदि के बिना frida टूलिंग का उपयोग करें। पता लगाने के विरुद्ध अंतर्निहित हाइडिंग पैच (ओपन-सोर्स और इन-हाउस) बनाए रखे जाते हैं; कनेक्शन FIRERPA पोर्ट पर टोकन प्रमाणीकरण का उपयोग करते हैं। objection पैच और Frida 17.x java-bridge सहायक माइग्रेशन को आसान बनाते हैं।

**सतत Frida स्क्रिप्ट्स** ऐप क्रैश या बाहर निकलने के बाद पुनः-इंजेक्ट होती हैं; निर्देशिका वॉच और हॉट रीलोड के साथ YAML ऑफ़लाइन दृढ़ता। Frida RPC JVM, UI मुख्य या शुद्ध JS थ्रेड्स पर **Python विधियों** और **HTTP + JSON-RPC 2.0** दूरस्थ कॉलों से मानचित्रित होता है। स्क्रिप्ट `emit` डेटा डिवाइस/ऐप मेटाडेटा, zlib संपीड़न, HTTP रीट्राय और MQTT TLS के साथ **HTTP / Redis / RabbitMQ (MQTT)** तक जा सकता है।

## ADB, SSH और अंतर्निहित टर्मिनल

FIRERPA में एक **स्टैंडअलोन अंतर्निहित ADB** शामिल है—**सिस्टम डेवलपर विकल्प सक्षम किए बिना** वायरलेस उच्च-विशेषाधिकार ADB, जो तब उपयोगी है जब ऐप्स डेवलपर मोड का पता लगाते हैं। Magisk मॉड्यूल डिफ़ॉल्ट प्राधिकरण के लिए `adb_keys` पूर्व-स्थापित कर सकते हैं। दूरस्थ शेल और फ़ाइल स्थानांतरण के लिए अंतर्निहित **SSH** के साथ `ssh.sh` / `scp.sh`।

**अंतर्निहित टर्मिनल** strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper और Crypto, cv2, unicorn, capstone, keystone, redis और grpc जैसे Python स्टैक के साथ आता है। sqlite3 WeChat, WeCom और Alibaba-परिवार क्लाइंट जैसे ऐप्स से एन्क्रिप्टेड डेटाबेस पढ़ने के लिए **wxsqlite / sqlcipher / sqlcrypto** का समर्थन करता है। रिमोट डेस्कटॉप, SSH और ADB में एक ही वातावरण—कम PC आवागमन के साथ डिवाइस पर विश्लेषण और नियंत्रण करें।

## वितरित और मल्टी-डिवाइस प्रबंधन

**FIRERPA StarLink प्लेटफ़ॉर्म (Hub + hub-bridge)** स्थानीय और दूरस्थ डिवाइसों के लिए एकीकृत प्रबंधन और **P2P** पहुँच के साथ केंद्रीकृत मल्टी-डिवाइस अभिगम प्रदान करता है—"घर पर डिवाइस, कहीं और ऑपरेटर" और मल्टी-डिवाइस सहयोग के लिए आदर्श। hub v3 स्थानीय और दूरस्थ डिवाइसों के लिए एकीकृत अनुरोधों हेतु **SAPI** का उपयोग करता है। Hub के अलावा, **frp फ़ॉरवर्डिंग** और **OpenVPN mesh** भी स्व-होस्टेड विकल्पों के रूप में समर्थित हैं, पूर्ण दस्तावेज़ीकरण और Docker समर्थन के साथ।

9.0 से, **P2P Bridge** पीयर कनेक्टिविटी और एक **अंतर्निहित वितरित कार्य प्रणाली** समर्थित हैं; 7.50 से, एक नेटवर्किंग सब्सक्रिप्शन सेवा उपलब्ध है ताकि आपको frp/OpenVPN स्व-होस्ट न करना पड़े। क्लाउड फ़ोन पूल, डिवाइस फ़ार्म और एमुलेटर क्लस्टरों के लिए डिज़ाइन किया गया—**बैच डिवाइस, हमेशा-चालू, बिना पर्यवेक्षण** संचालन।

## AI / MCP / एजेंट

FIRERPA में **streamable-http** पर एक **MCP सर्वर** (`/mcp/`) शामिल है, जिसमें टूल कॉल, संसाधन रीड, प्रॉम्प्ट, प्रगति सूचनाएँ और लॉग हैं—**Claude, Cursor** और अन्य MCP क्लाइंटों के साथ संगत। आधिकारिक MCP एक्सटेंशन `~/modules/extension` के अंतर्गत रहते हैं।

अंतर्निहित **`agent` कमांड** टूल कॉल के साथ किसी भी OpenAI-संगत API के माध्यम से डिवाइस को **प्राकृतिक भाषा** में चलाता है, जिसमें **vision** मोड और एक **OpenAI सिमेंटिक कार्य निष्पादक** शामिल है। वास्तविक डिवाइसों पर निर्धारित AI कार्यों के लिए इसे **crontab** के साथ जोड़ें।

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/92639519cee4c07efbe1da1030a4107808841995e15962977a1364f22df70248.gif" alt="MCP" width="100%">
</p>

## सिस्टम नियंत्रण और एक्सटेंशन

**160+ Python API** ऐप संचालन, फ़ाइल I/O, कमांड निष्पादन, डिवाइस स्थिति, WiFi, प्रॉक्सी, OpenVPN, शटडाउन/रीबूट, सेवा लॉग और बहुत कुछ कवर करती हैं। `setprop` **`ro.*`** रीड-ओनली प्रॉपर्टी लिख सकता है; Settings API चमक, डेवलपर मोड आदि समायोजित करती हैं; **SELinux** डोमेन निर्माण, पर्मिसिव मोड और सूक्ष्म अनुमति/अस्वीकृति। पूर्ण मल्टी-इंस्टेंस ऐप API, मौन अनुदान/रद्द अनुमतियाँ, गैर-निर्यातित activities लॉन्च करना, संसाधन बचाने के लिए ऐप्स अक्षम करना।

**बाइनरी पैचिंग** (hex वाइल्डकार्ड, glob पथ, dryrun) और डिस्क, बैटरी, CPU, मेमोरी और नेटवर्क I/O के लिए रनटाइम मेट्रिक्स। WAV प्लेबैक और आंतरिक स्टोरेज API। एज इन्फ़रेंस के लिए हार्डवेयर-त्वरित कंप्यूट के साथ ऑन-डिवाइस **tflite-runtime**।

एक **वर्चुअल Debian वातावरण** apt के साथ पूर्ण Debian चलाता है—BPF संकलित करें, OpenSSH तैनात करें, अंतर्निहित टर्मिनल की सीमाओं से परे मनमानी Python निर्भरताएँ स्थापित करें।

## परिनियोजन, सुरक्षा और प्रशासन

**एक-क्लिक APP** (रूट या Shizuku), **Magisk मॉड्यूल ऑटोस्टार्ट**, मैनुअल एक्सट्रैक्ट या **ROM एकीकरण** के माध्यम से परिनियोजित करें—**24/7** संचालन के लिए डिज़ाइन किया गया। APP **सेवा प्रमाणपत्र स्वतः-उत्पन्न** कर सकता है; Magisk zips प्रॉपर्टी, lamda.pem और adb_keys भेज सकते हैं। **INI सेवा कॉन्फ़िगरेशन** पोर्ट, WebUI, प्रमाणपत्र, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns आदि को केंद्रीकृत करता है; WebUI विज़ुअल संपादन, रॉ टेक्स्ट और Reload Service, साथ ही दूरस्थ कॉन्फ़िग फ़ाइल लोडिंग प्रदान करता है।

रूट और शेल पहचानें; arm64, armeabi-v7a, x86, x86_64; वास्तविक डिवाइस, एमुलेटर (LDPlayer, Nox, आदि), Redroid, WSA, AVD, क्लाउड फ़ोन। स्वच्छ अनइंस्टॉल पथ। **API एक्सक्लूसिव लॉक** क्लाइंट प्रतिस्पर्धा को रोकता है। गोपनीयता नीति: संपर्कों, SMS, स्थान आदि का कोई संग्रह नहीं; **ऑफ़लाइन लाइसेंसिंग** समर्थित है।

## टूलिंग और विकास

**छह वर्षों से अधिक** का निरंतर विकास, Android 14–16 संगतता सुधारों और मल्टी-यूज़र रिमोट डेस्कटॉप, मानकीकृत टच API, MCP, Frida संस्करणों और स्टील्थ, प्रॉक्सी IPv6/UDP, P2P Bridge और वितरित कार्यों पर चल रहे कार्य के साथ।

FIRERPA की ताकत कोई एक सुविधा नहीं है, बल्कि **रिमोट डेस्कटॉप (WebRTC/H.264/मल्टी-यूज़र), UI स्वचालन (वर्चुअल डिस्प्ले, Watcher, OCR, छवि मिलान, मल्टी-टच), एक-क्लिक कैप्चर, अंतर्निहित Frida, फुल-स्टैक प्रॉक्सी और VPN/frp/P2P, ADB/SSH/अंतर्निहित टर्मिनल, AI MCP/एजेंट, सिस्टम-स्तरीय नियंत्रण, वर्चुअल Debian, सतत KV और स्क्रिप्ट एन्क्रिप्शन** को एक Android डिवाइस, एक सेवा और एक Python क्लाइंट पर एकीकृत करना है—ताकि सुरक्षा परीक्षण, अनुपालन विश्लेषण, प्रोटोकॉल पुनर्प्राप्ति, फ्लीट प्रबंधन और स्वचालन कई जुड़े हुए टूलों के बजाय **एक पाइपलाइन** में चलें।