A lightweight, fast, and efficient Python tool to check the availability of Instagram usernames.
UsernameHunter automates the process of validating Instagram handles. Whether you are looking for a new personal brand name or checking a list of potential handles for a business, this script simplifies the process.
- Single & Bulk Mode: Check a single username or a text file containing thousands.
- Status Reporting: Clearly distinguishes between Available, Taken, and Banned/Invalid usernames.
- Output Logging: Automatically saves available usernames to a text file for easy retrieval.
- Lightweight: Minimal dependencies, easy to run on any machine with Python installed.
- Proxy Support: Compatible with proxies to avoid IP rate-limiting.
Before running the tool, ensure you have the following installed:
- Python 3.6+: Download Here
- Git: Download Here
-
Clone the repository:
git clone "https://github.com/mriityu/Username-Hunter.git" cd Username-Hunter
-
Install dependencies:
pip install -r requirements.txt
(Note: If you do not have a requirements.txt, ensure you have
requestsinstalled viapip install requests)
Run the main script from your terminal:
python main.py
- The script will ask if you want to check a single username or a list.
- If List: Ensure you have a file named
usernames.txtin the same directory. - The script will iterate through the names and print the status in the console.
- Green: Username is Available.
- Red: Username is Taken.
- Yellow: Error/Rate Limited.
Available usernames are automatically appended to available.txt.
Educational Purposes Only. This tool is designed for educational purposes and legitimate username research. Please do not use this tool to spam Instagram's servers. The developer is not responsible for any misuse of this script or any IP bans resulting from excessive requests.
Distributed under the MIT License. See LICENSE for more information.