       ____    ____         _____        __________   _____        ____   __________   __________   _____________

      |    |  |    |       /     \      |    ___   \  \    \      /    / |          | |          | |             | 

      |    |  |    |      /   _   \     |   |   |   \  \    \    /    /  |   _______| |     _____| |____     ____|

      |    |__|    |     /   /_\   \    |   |___/   |   \    \  /    /   |   |___     |    |_____       |   |

      |     __     |    /    ___    \   |    ___    /    \    \/    /    |    ___|    |______    |      |   |

      |    |  |    |   /    /   \    \  |   |   \   \     \        /     |   |______   ______|   |      |   |

      |    |  |    |  /    /     \    \ |   |    \   \     \      /      |          | |          |      |   |

      |____|  |____| /____/       \____\|___|     \___\     \___ /       |__________| |__________|      |___|   R







README



    HarvestR is a bot application program that uses a facial recongnition tool and web scraping technologies for open source

    intelligence research. HarvestR 1.01 currently operates on windows only but future versions will incoporate Mac OS.

    Running HarvestR requires installing multiple python libraries through terminal command. IDE's are not limited as long

    as it can import the required packages. HarvestR was built on python version 3.11.
	
	
	HarvestRencryption provides a set of functions for password hashing, verification, encryption, and decryption using the 
	
	bcrypt and cryptography libraries. It is designed to handle sensitive information securely.



NOTICE



    Participants involved in any project are fullyÂ informed about the nature,Â purpose, and methodologies involved,Â and their  

    onsent is obtained prior toÂ participation.Â  This project provides anÂ aggregate analysisÂ derivedÂ fromÂ publicly 

    available data sources. It is crucial toÂ acknowledge thatÂ theÂ information presented here isÂ intended exclusively forÂ 

    academic andÂ informationalÂ purposes. We firmly oppose andÂ abstain from personallyÂ employing facialÂ recognition technologies 

    or webÂ scraping methodsÂ thatÂ compromise individual privacy.



INSTALLATION & IMPORT REQUIREMENTS:



    - Python 3.11 or greater

    - cryptography
	
	- bcrypt


GITHUB LINK AND FILES:



    https://github.com/Ryeberg/OSINT_Bot





CONTACT ME



    If you have any problems running the application you can email me at arubi108@fiu.edu to answer all your concerning questions.

    You can also reach our github page for updates and announcements to address bugs and issues.



----------------------------------------------------------------------------------------------------------------------------------



INSTALLATION PROCEDURES BEFORE RUNNING:



    To install Python visit https://www.python.org/downloads/windows/ and select "Lastest Python 3 Release -Python #.##.#". 

    Once there scroll to the bottom until you see "Files" and select "Windows installer (64-bit)"



    To install selenium type in command prompt:  pip install selenium

    Documentation for installation can be found at https://selenium-python.readthedocs.io/installation.html

    

    tkinter is library that comes "pre-installed" with python standard library distributions. 

    But if not found use: pip install tk



    To install beautifulsoup type in command prompt: pip install beaufitulsoup4



    To install pyautogui type in command prompt: pip install pyautogui



    To install pywinstyles type in command prompt: pip install pywinstyles

   

    To install pyperclip type in command prompt: pip install pyperclip



    To acquire Drivers you can simply download the firefox browser or Google Chrome browser online



    To install customtkinter type in command prompt: pip install customtkinter



    Make sure to create a folder called Images in the same directory as the python file or download from github with 

    all the necessary images to run the bot. Without the images the program will not know where to go and it will 

    cause the application to crash.





METHODS AND DESCRIPTIONS OF USE:



    Hashing:    		   The script can hash a password and verify it against a stored hash. 
	
						   password_hash = hash_password("your_password_here")
                           assert verify_password(password_hash, "your_password_here")
                           

    Key Derivation:        Derive a cryptographic key from a password and salt.
	
	                       salt = os.urandom(16)
                           key = derive_key("your_password_here", salt)



    Encryption:            Encrypt securely.
	
	                       original_message = "Sensitive data here"
						   encrypted_message = encrypt_message(original_message, key)


 

                           