Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Tools for finding and storing profile pics of whatsapp contacts in large scale.

Project description


Tools for finding and storing profile pics of whatsapp contacts in large scale.


From pypi

$ pip install peoplefinder

From source (current version 1.0b1)

$ git clone
$ cd people-finder
$ python install

Telegram API token

If you plan to use peopleuploader functionalities, make sure your environment variable PEOPLE_API_TOKEN points to our bot.


A graphical interface will be implemented in future updates, but, for now, the usage is inline. We've set up the number's format to our country, Brazil (+55 XX XXXX-XXXX). A example of use is

$ peoplefinder -n 10 -d 84 -r

where the 10 refers to number of loops in search, 84 refers to the local area code of the phone numbers and the -r flag indicates random number generation

Alternatively one can create a list of numbers in a file named input.txt in the same directory and omit this flag.

Uploading to telegram @peoplefinder

$ peopleuploader [-s <savedir>] [-c]

This will upload all pictures inside savedir. The optional flag -c will clear the files simultaneously.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for peoplefinder, version 1.0b1
Filename, size File type Python version Upload date Hashes
Filename, size peoplefinder-1.0b1-py3.6.egg (12.6 kB) File type Egg Python version 3.6 Upload date Hashes View
Filename, size peoplefinder-1.0b1-py3-none-any.whl (8.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size peoplefinder-1.0b1.tar.gz (4.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page