AIHawk is an open-source AI agent designed to automate and personalize the job application process for job seekers. It aims to streamline the often time-consuming and repetitive task of applying to multiple jobs, providing users with a competitive edge in the job market.
How It Works
AIHawk leverages Large Language Models (LLMs) to tailor applications. Users configure their personal details, education, experience, and work preferences in YAML files. The agent then uses this information to generate personalized content for job applications, potentially including resume and cover letter generation. It supports various LLM providers like OpenAI, Ollama, Anthropic (Claude), and Google Gemini, allowing flexibility in model choice and deployment (local or cloud-based).
Quick Start & Requirements
- Install: Clone the repository, create a Python virtual environment, activate it, and run
pip install -r requirements.txt
.
- Prerequisites: Python 3.10+, Google Chrome, C++ build tools (for Windows).
- Configuration: Requires
secrets.yaml
with LLM API keys and plain_text_resume.yaml
with user profile data.
- Documentation: Ollama Setup, YAML Editing Guide.
Highlighted Details
- Supports multiple LLM backends (OpenAI, Ollama, Claude, Gemini).
- Detailed YAML configuration for comprehensive user profile and preferences.
- Includes troubleshooting guides for common issues like API rate limits and configuration errors.
- Past LinkedIn automation efforts were ceased due to platform requests; focus is now on a new AI-driven job board.
Maintenance & Community
- Project is maintained by open-source contributors, with the original creator focusing on a proprietary product.
- Community support available via a Telegram group.
- Contributions are welcomed via pull requests targeting the
release
branch.
Licensing & Compatibility
- Licensed under AGPL. Documentation is CC BY.
- AGPL requires derivative works to be open-sourced under the same license, potentially impacting commercial use or closed-source integration.
Limitations & Caveats
- Previous LinkedIn automation was removed due to platform enforcement.
- OpenAI API usage may be subject to rate limits and requires paid credits, with potential initial free tier limitations.
- Users must ensure compliance with platform terms of service and legal guidelines when using automated tools.