Open Source · MIT License · v2.0

Intelligence at Your Fingertips

A comprehensive Open Source Intelligence toolkit for Telegram.
30+ powerful modules for investigations, reconnaissance, and security research.

0+ Commands
0 Categories
0+ API Integrations
0+ Platforms
OSINT Bot — Telegram
$ python main.py
[INFO] OSINT Investigation Bot - Starting
[INFO] Database initialized.
[INFO] Proxy pool loaded: 3 proxies
[INFO] All handlers registered.
[INFO] Bot is running. Press Ctrl+C to stop.
$ 

Everything You Need for
Intelligence Gathering

Purpose-built for ethical security research, CTF competitions, and authorized investigations.

Inline Button UI

Navigate all 30+ commands through a clean, intuitive inline keyboard interface. No complex commands to memorize — just tap and explore.

Cross-Platform Search

Search usernames across 30+ platforms including GitHub, Reddit, X, Instagram, TikTok, YouTube, Facebook, LinkedIn, and Steam.

Privacy First

Built-in rate limiting, input sanitization, and audit logging. No sensitive data stored. All queries logged for accountability.

Proxy Rotation

Built-in proxy manager with sequential, random, and failover rotation modes. Supports HTTP, HTTPS, SOCKS4, and SOCKS5 proxies.

Lightweight & Fast

Minimal dependencies, async architecture, and smart caching ensure rapid responses. Deploy anywhere: VPS, Docker, Heroku, or HuggingFace Spaces.

Easy to Extend

Modular handler architecture makes it trivial to add new modules. Clean separation between API clients, handlers, and utilities.

30+ Powerful
Investigation Modules

Organized into 6 categories covering every aspect of OSINT and security research.

OSINT Investigation

11 modules
/ip IP geolocation & abuse intel
/domain DNS, WHOIS & VirusTotal
/user Username on 30+ platforms
/social Social media deep lookup
/malware Hash analysis (VirusTotal)
/email Email OSINT & validation
/emailrecon Deep email recon
/breach Data breach checker
/phone Phone reconnaissance
/number Number analysis
/dork Google dork generator

Image Intelligence

3 modules
/reverse Reverse image search
/face Face detection & analysis
/meta EXIF metadata extractor

Advanced Security

5 modules
/vuln CVE vulnerability scanner
/nuclei Template vuln scanner
/darkweb Breach monitor
/news Cybersecurity feed
/github Repo tracker & scanner

CTF & Developer Tools

3 modules
/password Secure password generator
/run Sandboxed code executor
/encode Hash & encoding tool

Network Reconnaissance

4 modules
/subdomain Subdomain enumeration
/dns Full DNS recon (10 types)
/whois WHOIS lookup
/port Port scanner

Utilities

4 modules
/urlscan URL safety analyzer
/qr QR code generator
/proxy Proxy manager
/stats Usage statistics

Start Investigating
in Seconds

Simply send a command to the bot and get instant results. All commands use inline buttons for easy interaction.

Youjust now
/ip 8.8.8.8
OSINT Botjust now
IP Intelligence Report

IP: 8.8.8.8
Location: Mountain View, California
ISP: Google LLC
Org: Google Public DNS
Abuse Score: Low (0%)
Open Ports: 53 (DNS)
Youjust now
/user sherlock
OSINT Botjust now
Username Results

✔ GitHub — github.com/sherlock
✔ Reddit — reddit.com/user/sherlock
✘ TikTok — Not found
✔ YouTube — youtube.com/@sherlock
✘ Instagram — Not found
Found on 18/30 platforms
Youjust now
/vuln CVE-2024-3094
OSINT Botjust now
Vulnerability Report

CVE: CVE-2024-3094
Severity: CRITICAL (10.0)
Product: xz utils
Description: Malicious backdoor in xz liblzma
Published: 2024-03-29

Built with
Security in Mind

Every layer of the bot is designed with security best practices.

Input Validation

Every command input is sanitized and validated before processing. No injection attacks possible.

Rate Limiting

Sliding-window rate limiting (10 req/60s per user) prevents abuse and API quota exhaustion.

Audit Logging

All queries are logged to SQLite with timestamps for accountability. Passwords and sensitive data are never logged.

Sandboxed Execution

Code runner uses blacklisted commands, timeout limits, and output size restrictions to prevent misuse.

Environment Secrets

All API keys and tokens stored as environment variables. No hardcoded credentials in source code.

Ethical Disclaimers

Educational disclaimers present throughout the bot. Designed for authorized security research only.

Deploy in
Minutes

Multiple deployment options. Pick what works best for you.

VPS / Bare Metal

git clone https://github.com/gamingextra/osint-bot.git
cd osint-bot && pip install -r requirements.txt
cp .env.example .env && nano .env
python main.py

Docker

docker build -t osint-bot .
docker run -d --env-file .env osint-bot
Recommended

Cloud Platforms

Heroku / Railway / Fly.io / Render
HuggingFace Spaces (Docker SDK)
Just connect repo and set env vars

Clean, Modular
Architecture

Interface Layer
Telegram Bot API
Inline Keyboards
Callback Queries
Handler Layer (22+ modules)
OSINT Handlers
Security Handlers
Utility Handlers
Service Layer
API Clients
Proxy Manager
Rate Limiter
Data Layer
SQLite Database
Config / Env
Logger
Python 3.10+ python-telegram-bot aiohttp dnspython Pillow SQLite Docker Nuclei API Async/Await

Ready to Start Investigating?

Deploy your own OSINT bot in minutes. Open source, well documented, and ready to go.