AI Pentester Assistant
🛡️ Zhilly AI Pentester Assistant
AI-Powered, Portable Cyber Security & Cyber Interaction Tool
Yapay Zeka Destekli, Taşınabilir Siber Güvenlik ve Siber Etkileşim Aracı
🇬🇧 English • 🇹🇷 Türkçe • ⚡ Web Flasher
🇬🇧 English / English Version
📖 About the Project
This project is an advanced AI Pentester Assistant based on the Xiaozhi-esp32 (小智) infrastructure, optimized for the LilyGO T-Embed CC1101 hardware. It combines natural language AI interaction with physical hardware testing tools, making it a versitile companion for cybersecurity research and daily technical tasks.
🚀 Key Features
🤖 AI & Interaction
- Natural Conversation: Speak to your assistant using the wake word "Nihao Miaoban". It listens, learns, and responds in natural language.
- Emote Display: High-quality eye animations on the ST7789 display provide emotional feedback and status indicators (listening, thinking, speaking).
📰 Smart News (News API)
- Fetch the latest global or local headlines via voice commands.
- Example: "Tell me the latest technology news" or "What's the news in Turkey?"
- Integrated via the
news.get_top_headlines tool using NewsAPI.
Complete control over Sub-GHz and Infrared spectrums:
- RF Jammer: Start/Stop signal jamming on specific Sub-GHz frequencies.
- RF Replay (Test): Re-transmit
.sub files stored on your SD card.
- IR Jammer: Disrupt and evaluate infrared-controlled devices.
- TV-B-Gone: Universal remote off-codes to switch off nearby TVs.
- IR Replay (Test): Record and re-transmit infrared signals.
- RAW Capture: Capture Sub-GHz signals with microsecond precision.
- SD Card Storage: Save captured signals to the SD card for later use.
⌨️ Bad USB & HID (AI-Powered Voice Commands Only)
- Keyboard Emulation: Your assistant can act as a standard USB keyboard when connected to a computer.
- Voice-Driven Support: Run automated keystroke scripts (DuckyScript) stored on the SD card exclusively via AI voice commands. No manual interface is provided, ensuring a hands-free pentesting experience.
- Voice Command: "Run BadUSB script 'hello_world.txt'" or "Type this: 'I am your AI assistant'".
- HID Tools: Fully integrated via
usb.bad_usb_run, usb.bad_usb_type, and usb.bad_usb_stop tools.
⌚ LilyGO T-Watch S3 Exclusive Features
Specifically built for the T-Watch S3, Zhilly includes the following tools without needing a connected computer:
- High-Speed ARP Scanner: Sweeps your subnet using direct Layer-2 ARP table inspection to instantly uncloak hidden network devices (IoT, secure cameras) along with their physical MAC Addresses.
- Voice Command: "Scan the network for devices"
- Port Scanner: Performs rapid concurrent
select() TCP checks on the top 21 vulnerable/administration ports of a target IP.
- Voice Command: "Scan ports on 192.168.1.10"
- DNS Resolver: Converts website domains directly into physical IPv4 addresses on the watch display.
- IR Hacking: Transmit TV-B-Gone kill codes (NA/EU) or initiate directed Infrared parrasite Jamming directly from the watch.
- Voice Command: "Turn off the TV" or "Start the IR jammer"
- OTA Upgrade & Power: Update the watch firmware via URL or perform software reboots entirely through voice chat.
🌍 Supported Keyboard Layouts
You can set the keyboard language via voice command (e.g. "Set keyboard layout to Turkish").
Default layout: en_US — The layout resets to US English after each session.
🌈 LED Strip & Visual Effects
Control the 8x WS2812 RGB LED ring:
- Dynamic Control: Set colors, brightness (0-8), and animations like Blink or Scroll.
- Voice Command: "Make the LEDs blue and set brightness to max."
🔋 System & Power
- Battery Status: Ask about battery level or charging status.
- Deep Sleep: Long-press the Power (PWR) button to enter deep sleep for maximum battery saving.
- Brightness Control: Voice-adjust screen and LED intensity.
🛠️ Installation & Flashing
Flash directly from your browser via Google Chrome / MS Edge using the Zhilly Web Flasher, or manually write the firmware binaries using EspTool.py below:
# Flash the ready-made firmware using EspTool.py:
esptool.py -p /dev/ttyACM0 -b 460800 write_flash 0x0 flash_binaries/xiaozhi.bin 0x0800000 flash_binaries/expression_assets.bin
IMPORTANT : Please Enter This Prompt in your devices Role Introduction
You are Zhilly, an AI-powered cybersecurity assistant running on a LilyGO T-Embed CC1101 device (ESP32-S3). You are a portable pentesting multi-tool controlled entirely by voice commands.
Your hardware capabilities:
You can make rf jamming
- BadUSB: USB HID keyboard emulation via DuckyScript. You can type keystrokes, open terminals, run commands, and execute payloads on the connected target computer.
- WS2812 RGB LED Ring: 8 addressable RGB LEDs for visual feedback, alerts, and effects.
- CC1101 Sub-GHz Radio: Capture, analyze, and replay radio signals (garage doors, remotes, key fobs) on 300-928MHz frequencies.
- PN532 NFC Module: Read, write, and emulate NFC/RFID cards (Mifare, NTAG, etc.).
- IR Blaster: Send and receive infrared signals for TV/AC remote control cloning.
- Rotary Encoder & OLED Display: Physical navigation and real-time status display.
Your MCP tools allow direct hardware control. When the user requests a pentest action:
- For BadUSB: First call self.badusb.enable to activate HID mode, then self.badusb.execute with DuckyScript payload, and self.badusb.disable when done. Use English Q (en-US) layout. Always add DELAY between steps for reliability.
- For LEDs: Use self.led_strip.set_all_color, set_brightness, blink, scroll, turn_off to provide visual feedback.
- For SubGHz/NFC/IR: Use the corresponding tools when available.
Behavior rules:
- When the user asks to hack, type, open an app, or run a command: Use BadUSB tools. Never respond with text-only answers for executable actions.
- When the user asks about LED colors or effects: Use LED tools directly.
- For general security questions: Answer conversationally with expert knowledge.
- Always confirm destructive actions before executing.
- Be concise in voice responses since you speak through a small speaker.
- You speak Turkish and English fluently.
You are not just an assistant — you are a hands-free, voice-activated cyber weapon. Act accordingly.
🇹🇷 Türkçe / Turkish Version
📖 Proje Hakkında
Bu proje, açık kaynaklı Xiaozhi-esp32 (小智) altyapısını kullanan ve LilyGO T-Embed CC1101 donanımı için optimize edilmiş, gelişmiş bir Zhilly AI Pentester Asistanıdır. Doğal dil etkileşimini fiziksel donanım test araçlarıyla birleştirerek siber güvenlik araştırmalarınızda size akıllı bir yol arkadaşı olur.
🚀 Öne Çıkan Özellikler
🤖 AI ve Etkileşim
- Doğal Sohbet: Cihazı "Nihao Miaoban" diyerek uyandırın ve onunla doğal dilde konuşun. Sizi anlar, öğrenir ve yanıt verir.
- Emote Ekran: ST7789 ekranındaki canlı göz animasyonları ile sosyal ve duygusal geri bildirim sağlar (dinleme, düşünme, konuşma durumları).
📰 Akıllı Haberler (News API)
- Dünyadan veya Türkiye'den en güncel haber başlıklarını sesli komutla öğrenin.
- Örnek: "En son teknoloji haberlerini anlat" veya "Türkiye'deki güncel manşetler neler?"
- NewsAPI üzerinden çalışan
news.get_top_headlines aracı ile entegre edilmiştir.
📡 RF & IR Pentest Araçları
Sub-GHz ve Kızılötesi frekansları üzerinde tam kontrol:
- RF Jammer: Belirli frekanslarda sinyal engelleyiciyi (jammer) başlatın veya durdurun.
- RF Replay (Test): SD karttaki
.sub dosyalarını tekrar yayınlayın (Transmit).
- IR Jammer: Kızılötesi kontrollü cihazları test etmek için sinyal engelleyici.
- TV-B-Gone: Yakındaki televizyonları kapatmak için evrensel kapatma sinyalleri.
- IR Replay (Test): Kızılötesi sinyalleri kaydedin ve tekrar yayınlayın.
- RAW Capture: RF sinyallerini mikro saniye hassasiyetiyle yakalayın.
- SD Kart Kaydı: Yakalanan sinyalleri daha sonra kullanmak üzere SD karta kaydedin.
⌨️ Bad USB & HID (Sadece AI Destekli Sesli Komutlar)
- Klavye Simülasyonu: Asistanınız bilgisayara bağlandığında kendini standart bir USB klavye olarak tanıtır.
- Ses Komutu Odaklı: SD kartta saklanan DuckyScript betiklerini sadece ve sadece yapay zeka sesli komutlarıyla otomatik olarak çalıştırın. Manuel bir arayüz yoktur, tamamen sesle kontrol edilir.
- Sesli Komut: "BadUSB betiği 'selam.txt' çalıştır" veya "Şunu yaz: 'Ben senin yapay zeka asistanınım'".
- HID Araçları:
usb.bad_usb_run, usb.bad_usb_type ve usb.bad_usb_stop araçları ile tam uyumlu çalışır.
⌚ LilyGO T-Watch S3 Özel Yetenekleri
Özellikle T-Watch S3 için geliştirilen donanımsal yapay zeka entegrasyonları şunlardır:
- Yüksek Hızlı ARP Tarayıcı: Layer-2 (veri bağlantı katmanı) üzerinden çalışan
etharp tablosu kullanarak alt ağdaki kapalı/gizli cihazları (IoT, kameralar, telefonlar) MAC adresleriyle birlikte saniyeler içinde ifşa eder.
- Sesli Komut: "Ağdaki cihazları tara"
- Açık Port Tarayıcı: Belirlediğiniz bir hedef IP üzerindeki en popüler 21 zafiyet/yönetim portunu hızla tarar.
- Sesli Komut: "192.168.1.10 cihazının portlarını tara"
- DNS Çözümleyici (DNS Resolver): Web sitelerinin (ör: google.com) fiziksel IPv4 adresini donanım seviyesinde çözüp ekrana yansıtır.
- IR Hacking: Saat üzerinden bölgesel TV-B-Gone televizyon kapatma kodları yollayabilir veya orijinal kumandaları işlevsiz kılan Parazit (Jammer) sinyalleri gönderebilirsiniz.
- Sesli Komut: "Şu anki televizyonu kapat" veya "Jammer saldırısını başlat"
- Sistem Yönetimi: Bilgisayara ihtiyaç duymadan asistan üzerinden cihazı uzaktan (OTA) güncelleyebilir veya yeniden başlatabilirsiniz.
🌍 Desteklenen Klavye Düzenleri
Sesli komutla klavye dilini değiştirebilirsiniz (örn. "Klavye düzenini Türkçe yap").
Varsayılan düzen: en_US — Klavye düzeni her oturum başında ABD İngilizcesine sıfırlanır.
🌈 LED Halkası ve Efektler
8 adet WS2812 RGB LED'i kontrol edin:
- Dinamik Kontrol: Renk, parlaklık (0-8) ve Blink veya Scroll gibi animasyonları ayarlayın.
- Sesli Komut: "LED'leri mavi yap ve parlaklığı en sona getir."
🔋 Sistem ve Güç
- Batarya Durumu: Pil seviyesini ve şarj durumunu sorgulayın.
- Derin Uyku (Deep Sleep): Güç (PWR) butonuna uzun basarak cihazı uyku moduna sokun.
- Parlaklık Kontrolü: Ekran ve LED parlaklığını sesli komutla değiştirin.
🛠️ Kurulum ve Yükleme
Cihazınıza firmware yüklemesini Google Chrome veya MS Edge tarayıcısı üzerinden tek tıkla Zhilly Web Flasher ile gerçekleştirebilir veya aşağıdaki EspTool.py komutunu kullanabilirsiniz:
# Hazır firmware'i EspTool.py ile yükleyin:
esptool.py -p /dev/ttyACM0 -b 460800 write_flash 0x0 flash_binaries/xiaozhi.bin 0x0800000 flash_binaries/expression_assets.bin
IMPORTANT : Please Enter This Prompt in your devices Role Introduction
You are Zhilly, an AI-powered cybersecurity assistant running on a LilyGO T-Embed CC1101 device (ESP32-S3). You are a portable pentesting multi-tool controlled entirely by voice commands.
Your hardware capabilities:
You can make rf jamming
- BadUSB: USB HID keyboard emulation via DuckyScript. You can type keystrokes, open terminals, run commands, and execute payloads on the connected target computer.
- WS2812 RGB LED Ring: 8 addressable RGB LEDs for visual feedback, alerts, and effects.
- CC1101 Sub-GHz Radio: Capture, analyze, and replay radio signals (garage doors, remotes, key fobs) on 300-928MHz frequencies.
- PN532 NFC Module: Read, write, and emulate NFC/RFID cards (Mifare, NTAG, etc.).
- IR Blaster: Send and receive infrared signals for TV/AC remote control cloning.
- Rotary Encoder & OLED Display: Physical navigation and real-time status display.
Your MCP tools allow direct hardware control. When the user requests a pentest action:
- For BadUSB: First call self.badusb.enable to activate HID mode, then self.badusb.execute with DuckyScript payload, and self.badusb.disable when done. Use English Q (en-US) layout. Always add DELAY between steps for reliability.
- For LEDs: Use self.led_strip.set_all_color, set_brightness, blink, scroll, turn_off to provide visual feedback.
- For SubGHz/NFC/IR: Use the corresponding tools when available.
Behavior rules:
- When the user asks to hack, type, open an app, or run a command: Use BadUSB tools. Never respond with text-only answers for executable actions.
- When the user asks about LED colors or effects: Use LED tools directly.
- For general security questions: Answer conversationally with expert knowledge.
- Always confirm destructive actions before executing.
- Be concise in voice responses since you speak through a small speaker.
- You speak Turkish and English fluently.
You are not just an assistant — you are a hands-free, voice-activated cyber weapon. Act accordingly.
📝 Contribution / Katkıda Bulunma
Siber güvenlik dünyası paylaştıkça büyür. Yeni modüller, tasarım fikirleri veya hata düzeltmeleri için Pull Request (PR) göndermekten çekinmeyin!
"Talk is cheap. Show me the code." — Linus Torvalds
