🌐 PentestHorizon: Telegram Web Pentesting Bot 🔍

Overview

PentestHorizon is an advanced Telegram bot designed to assist security professionals and ethical hackers in performing web reconnaissance, enumeration, scanning, and vulnerability assessments.

🚀 Features

Modules

• Reconnaissance (/recon): Gather initial information about target domains
• Enumeration (/enum): Discover potential entry points and services
• Network Scanning (/scan): Identify open ports and network details
• Vulnerability Assessment (/vulac): Preliminary vulnerability detection

🤖 Telegram Bot Commands

• /start: Initialize bot interaction
• /help: Display comprehensive help menu
• /menu: Show available pentesting commands
• /recon [target]: Perform reconnaissance
• /enum [target]: Perform enumeration
• /scan [target]: Perform network scanning
• /vulac [target]: Conduct vulnerability assessment
• /misc: Information about upcoming tools

🛠 Installation

Prerequisites

• Python 3.9+
• Telegram Bot Token
• HackerTarget API Key (Optional but recommended)

Setup Steps

1. Clone the repository

git clone https://github.com/yourusername/PentestHorizon.git
cd PentestHorizon

2. Create virtual environment

python3 -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

3. Install dependencies

pip install -r requirements.txt

4. Configure Environment Variables Create a .env file with:

TELEGRAM_BOT_TOKEN=your_telegram_bot_token
HACKERTARGET_API_KEY=your_hackertarget_api_key

5. Run the Bot

python src/main.py

🔒 Security and Ethical Use

• IMPORTANT: This tool is for educational and authorized penetration testing
• Always obtain proper authorization before scanning or testing any systems
• Respect privacy and legal boundaries

📦 Dependencies

• python-telegram-bot
• requests
• python-dotenv
• aiohttp
• dnspython
• shodan

🛡️ Upcoming Features

• Advanced Vulnerability Scanning
• Automated Exploit Frameworks
• Comprehensive Security Auditing Tools

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📜 License

Distributed under the MIT License. See LICENSE for more information.

📞 Contact

Linkedin Link: Sarthak Lad

Project Link: Sarthaklad1034/PentestHorizon

---

Disclaimer: This tool is for educational purposes only. Unauthorized scanning or testing of systems you do not own is illegal.