AIHawk the first Jobs Applier AI Agent

🤖🔍 Your AI-powered job search assistant. Automate applications, get personalized recommendations, and land your dream job faster.

Creator feder-cr, Co-Founder of AIHawk
As AIHawk is focusing on their proprietary product - solving problems in hiring for companies, currently this project is led, managed, and maintained by a group of open-source contributors, with a focus on building tools to help job seekers land the jobs they deserve.

Project Maintainers / Leads: surapuramakhil, sarob, cjbbb

Special thanks

Auto_Jobs_Applier_AIHawk is continuously evolving, and your feedback, suggestions, and contributions are highly valued. Feel free to open issues, suggest enhancements, or submit pull requests to help improve the project. Let's work together to make Auto_Jobs_Applier_AIHawk a powerful tool for job seekers worldwide.

Table of Contents

1. Introduction
2. Features
3. Installation
4. Configuration
5. Usage
6. Documentation
7. Troubleshooting
8. Conclusion
9. Contributors
10. License
11. Disclaimer

Introduction

Auto_Jobs_Applier_AIHawk is a cutting-edge, automated tool designed to revolutionize the job search and application process. In today's fiercely competitive job market, where opportunities can vanish in the blink of an eye, this program offers job seekers a significant advantage. By leveraging the power of automation and artificial intelligence, Auto_Jobs_Applier_AIHawk enables users to apply to a vast number of relevant positions efficiently and in a personalized manner, maximizing their chances of landing their dream job.

The Challenge of Modern Job Hunting

In the digital age, the job search landscape has undergone a dramatic transformation. While online platforms have opened up a world of opportunities, they have also intensified competition. Job seekers often find themselves spending countless hours scrolling through listings, tailoring applications, and repetitively filling out forms. This process can be not only time-consuming but also emotionally draining, leading to job search fatigue and missed opportunities.

Enter Auto_Jobs_Applier_AIHawk: Your Personal Job Search Assistant

Auto_Jobs_Applier_AIHawk steps in as a game-changing solution to these challenges. It's not just a tool; it's your tireless, 24/7 job search partner. By automating the most time-consuming aspects of the job search process, it allows you to focus on what truly matters - preparing for interviews and developing your professional skills.

Features

1. Intelligent Job Search Automation

   • Customizable search criteria
   • Continuous scanning for new openings
   • Smart filtering to exclude irrelevant listings

2. Rapid and Efficient Application Submission

   • One-click applications
   • Form auto-fill using your profile information
   • Automatic document attachment (resume, cover letter)

3. AI-Powered Personalization

   • Dynamic response generation for employer-specific questions
   • Tone and style matching to fit company culture
   • Keyword optimization for improved application relevance

4. Volume Management with Quality

   • Bulk application capability
   • Quality control measures
   • Detailed application tracking

5. Intelligent Filtering and Blacklisting

   • Company blacklist to avoid unwanted employers
   • Title filtering to focus on relevant positions

6. Dynamic Resume Generation

   • Automatically creates tailored resumes for each application
   • Customizes resume content based on job requirements

7. Secure Data Handling

   • Manages sensitive information securely using YAML files

Installation

Confirmed successful runs on the following:

• Operating Systems:
  • Windows 10
  • Ubuntu 22
  • macOS
• Python versions:
  • 3.13

Prerequisites

Before you begin, ensure you have met the following requirements:

Download and Install Python

Ensure you have the latest Python version installed (Python 3.8 or higher is required for Poetry). If not, download and install it from Python's official website. For detailed instructions, refer to the tutorials:

• How to Install Python on Windows
• How to Install Python on Linux
• How to Download and Install Python on macOS

Download and Install Google Chrome

Download and install the latest version of Google Chrome in its default location from the official website.

Install Poetry

Follow the instructions provided on Poetry's official installation page.

Clone the Repository

git clone https://github.com/surapuramakhil-org/Job_hunt_assistant.git
cd Job_hunt_assistant

switching to stable versions

place to find release tags: https://github.com/surapuramakhil-org/Job_search_assistant/releases

git checkout <tag_name>

example:

git checkout v0.1.0-beta

Setting Up the Project with Poetry

Since the project already includes a pyproject.toml file, follow these steps:

Install Dependencies

Run the following command in the project directory to install all dependencies specified in pyproject.toml:

poetry install

Create .env File

To configure environment variables for the project, create a .env file by copying the .env.template file provided in the repository. This file will store sensitive information such as API keys and other configuration settings.

cp .env.template .env

After copying, open the .env file and fill in the required values. Ensure you do not share this file or commit it to version control, as it contains sensitive information.

Run the Program

After installing dependencies, run the program using:

poetry run python src/main.py

For configuration refer this docs

For troubleshooting refer this docs

Usage

0. Account language To ensure the bot works, your account language must be set to English.

1. Data Folder: Ensure that your data_folder contains the following files:

   • secrets.yaml
   • config.yaml
   • plain_text_resume.yaml

2. Output Folder: Contains the output of the bot.

   • data.json results of the --collect mode
   • failed.json failed applications
   • open_ai_calls.json all the calls made to the LLM model
   • skipped.json applications that were skipped
   • success.json successful applications

   Note: answers.json is not part of the output folder and can be found in the root of the project. It is used to store the answers of the questions asked to the user. Can be used to update the bot with corrected answers. Search for Select an option, 0, Authorized, and how many years of to verify correct answers.

3. Run the Bot:

   Auto_Jobs_Applier_AIHawk offers flexibility in how it handles your pdf resume:

• Dynamic Resume Generation: If you don't use the --resume option, the bot will automatically generate a unique resume for each application. This feature uses the information from your plain_text_resume.yaml file and tailors it to each specific job application, potentially increasing your chances of success by customizing your resume for each position.

  poetry run python main.py

• Using a Specific Resume: If you want to use a specific PDF resume for all applications, place your resume PDF in the data_folder directory and run the bot with the --resume option:

  poetry run python main.py --resume /path/to/your/resume.pdf

• Using the collect mode: If you want to collect job data only to perform any type of data analytics you can use the bot with the --collect option. This will store in output/data.json file all data found from linkedin jobs offers.

  poetry run python main.py --collect

Documentation

For Users

• Ollama & Gemini Setup

  • To install and configure Ollama and Gemini, Download Ollama and Gemini Setup Guide (PDF)
  • Follow the instructions in these guides to ensure proper configuration of AIHawk with Ollama and Gemini.
  • Written by Rushi, Linkedin, support him by following.

• Editing YAML Files

  • For detailed instructions on editing YAML configuration sections for AIHawk, refer to this document:
  • Download YAML Editing Guide (PDF)
  • Written by Rushi, Linkedin, support him by following.

• Auto-start AIHawk

  • To make AIHawk automatically start when your system boots, follow the steps in this guide:
  • Download Auto-start AIHawk Guide (PDF)
  • Written by Rushi, Linkedin, support him by following.

• Video Tutorial

  • How to set up Auto_Jobs_Applier_AIHawk
  • Written by Rushi, Linkedin, support him by following.

• OpenAI API Documentation

For Developers

• Contribution Guidelines

• Lang Chain Developer Documentation

• Workflow diagrams

• If you encounter any issues, you can open an issue on GitHub. Please add valuable details to the subject and to the description. If you need new feature then please reflect this.
  I'll be more than happy to assist you!

• Note for Contributors: If you would like to submit a Pull Request (PR), please target the release branch instead of main. The release branch is used for testing new code changes and will be periodically merged into main after validation. This approach ensures that only tested features make it into the main branch.

Conclusion

Auto_Jobs_Applier_AIHawk provides a significant advantage in the modern job market by automating and enhancing the job application process. With features like dynamic resume generation and AI-powered personalization, it offers unparalleled flexibility and efficiency. Whether you're a job seeker aiming to maximize your chances of landing a job, a recruiter looking to streamline application submissions, or a career advisor seeking to offer better services, Auto_Jobs_Applier_AIHawk is an invaluable resource. By leveraging cutting-edge automation and artificial intelligence, this tool not only saves time but also significantly increases the effectiveness and quality of job applications in today's competitive landscape.

Star History

If you like the project please star ⭐ the repository!

Special Thanks

Made with contrib.rocks.

License

This project is licensed under the AGPL License. Documentation is licensed under CC BY - see the AGPL LICENSE and CC BY LICENSE files for details.

The AGPL License requires that any derivative work must also be open source and distributed under the same license.

The CC BY License permits others to distribute, remix, adapt, and build upon your work, even for commercial purposes, as long as they credit you for the original creation.

Disclaimer

This tool, Auto_Jobs_Applier_AIHawk, is intended for use at your own risk. The creators / maintainers / contributors assume no responsibility for any consequences arising from its use. Users are advised to comply with the terms of service of relevant platforms and adhere to all applicable laws, regulations, and ethical guidelines. The use of automated tools for job applications may carry risks, including potential impacts on user accounts. Proceed with caution and at your own discretion.

Back to top 🚀