◈ TELE-TRACE INTELLIGENCE
A local web-based Telegram OSINT tool built with Flask + Telethon. Runs entirely on your device — no cloud, no data sharing.
- Python 3.8+
- Termux (Android) or Linux/macOS
- Telegram account + API credentials
# Clone the repository
git clone https://github.com/anubhavanonymous/Tele-Trace
cd Tele-Trace
# Install dependencies
pip install -r requirements.txt
# On Termux
pip install -r requirements.txt --break-system-packages- Visit https://my.telegram.org and log in
- Click API Development Tools
- Create a new app (any name)
- Copy your API ID and API Hash
⚠ Use an aged Telegram account (1+ years old) for best results. New accounts are heavily restricted by Telegram and may fail to resolve phone number lookups or get temporarily banned from making API requests.
🔒 It is strongly recommended not to use your real/primary Telegram account. Use a dedicated throwaway account to avoid any risk to your personal account.
python tele-trace.pyOpen http://localhost:7777 in your browser.
- Enter your API ID, API Hash, and phone number
- Select your country code from the dropdown
- Click Continue — you'll receive a code in Telegram
- Enter the code. If you have 2FA enabled, enter your password too
- Session is saved locally — next launch skips login automatically
To switch accounts, click Switch Account in the top bar.
Search by phone number or @username. Extracts:
- Name, bio, last seen status
- User ID, phone, all active usernames
- Account flags: Bot, Fake, Scam, Premium, Verified
- Profile photos and video DPs with upload dates
Estimates account creation date from the user ID using Telegram's sequential ID system. Accurate to ±1-2 months.
0–100% confidence score based on 9 factors: username pattern, bio presence, photo count, account age, status visibility, name history, premium/verified status, no flags, and platform presence.
- Pattern detection (name_surname, CamelCase, gaming style, etc.)
- Type — Likely real name vs Nickname/Handle (detects shadow, ghost, king, wolf, hacker, cyber, etc.)
- Possible real name extraction
- Name Origin — Indian, Arabic/Muslim, Russian/Slavic, Western, Chinese/Korean
- Name Meaning — dictionary of common names (e.g. Aditya = Sun/First, Arjun = Bright, Ali = High/Exalted)
- Possible region from name roots
- Birth year detection (extended range: 1970–2022)
- Name Match — compares username tokens vs display name, shows consistency score
- Entropy score
- Language detection (Hindi, Arabic, Russian, Chinese, Korean, English + mixed)
- Possible name extraction
- Age detection — patterns like
21 y.o,born 2002,class of 2020 - Gender signals — pronouns (he/him, she/her, they/them) + gender emojis
- Occupation — 11 categories: Developer, Designer, Student, Content Creator, Entrepreneur, Trader, Writer, Artist, Gamer, Cybersecurity, Doctor/Medical
- Location hints — flag emojis + 40+ city/country name detection
- Relationship status — Single, In a relationship, Engaged, Married, Parent
- Religion signals — Islam, Christianity, Hinduism, Sikhism via keywords + symbols
- Email in bio — extracts any email address present
- Phone in bio — extracts phone numbers present
- Crypto presence — keyword detection + BTC/ETH wallet address extraction
- External links (Instagram, GitHub, bare domains like site.com, etc.)
- Emotion score (Positive / Negative / Neutral)
- Emoji usage — flags heavy emoji use (5+ emojis)
- Hashtags and @mentions
Queries SangMata bot for recorded name/username changes with timestamps. History request is sent before photo downloads so the reply is ready by the time scanning completes.
Checks the username across 9 platforms simultaneously:
| Platform | Detection Method |
|---|---|
| GitHub | Signup check API |
| web_profile_info API + page fallback | |
| Body text check | |
| TikTok | statuscode 10202 = not found |
| Snapchat | HTTP 200/404 |
| Body text check | |
| Discord | POST API — JSON taken field |
| Twitterbot UA trick | |
| Medium | Profile meta tag + body detection |
Found profiles show as clickable links.
Each photo card has Google Lens and Yandex buttons. Photos are pre-uploaded to catbox.moe in the background after scan — clicking opens results instantly.
- JSON — full structured data including trust score, username intel, bio analysis, history, cross-platform results, media
- PDF — printable HTML report with all sections. Open in browser → Print → Save as PDF
| Problem | Fix |
|---|---|
| OTP fails | Check API ID and Hash are correct |
| No account found for phone | Number has no Telegram or privacy blocked. Try username search |
| Photos not loading | WebP issue on Android. Use Save button to download |
| History shows no data | Bot quota may be exceeded. Check reset time shown in UI |
| Platform scan all errors | Some platforms block your network. Try a VPN |
| Reverse image upload fails | catbox.moe may be down. Save photo and upload manually |
Tele-Trace/
├── tele-trace.py # Flask backend + Telethon logic
├── requirements.txt # Python dependencies
├── README.md
├── templates/
│ └── index.html # Frontend (HTML + CSS + JS)
└── static/ # Static assets
This tool is for educational and authorized research purposes only.
- Only interacts with publicly accessible Telegram data
- Does not bypass any privacy settings or authentication
- Users are responsible for compliance with applicable laws
- Author assumes no liability for misuse
Anubhav Kashyap
Telegram / GitHub: @anubhavanonymous