[ { "path": ".gitignore", "content": ".DS_Store" }, { "path": "FAQ.md", "content": "## FAQ\n\n- **Q: Can you apply to all jobs on LinkedIn?**\n\n JobHuntr applies to all jobs with the “Easy Apply” option on LinkedIn (about 70% of jobs).\n\n- **Q: Does it work for all job types?**\n\n Yes!\n\n- **Q: How many jobs can I apply to per day?**\n\n Up to **25** applications daily.\n\n- **Q: How can I check the questions that were previously filled out?**\n\n Go to the **History** tab and scroll all the way to the right. Click on **“Show Q&A”** to view the details of previously answered questions.\n\n ![history_page](src/history.png)\n\n- **Q: Will my Linkedin account be banned?**\n\n No. All actions are designed to mimic human behavior, with built-in randomness. Additionally, all requests are sent from your own IP address, making it extremely difficult for LinkedIn to detect any automation.\n\n- **Q: Why should I trust the AI’s filling?**\n\n You can choose to save all jobs to the “Queue” and mark them by confidence. The more questions you submit, the smarter it gets. Eventually, it will build your trust and confidence.\n\n ![queue](src/queue.png)\n\n- **Q: Why is my on-device AI getting stuck on a question?**\n\n If you choose a model larger than 4B, some personal laptops may struggle to run it efficiently or experience significant slowdowns—especially when processing long input contexts, such as resumes. The initial response time can be particularly slow, but performance typically improves as the model continues running.\n\n- **Q: Which countries are supported?**\n\n Currently, JobHuntr supports job searches in the following countries:\n - United States\n - Canada\n - Australia\n - United Kingdom\n\n- **Q: Which cities are supported?**\n\n JobHuntr supports major cities in each country:\n\n **United States:**\n - New York, NY\n - Houston, TX\n - Chicago, IL\n - Atlanta, GA\n - Los Angeles, CA\n - Dallas, TX\n - Austin, TX\n - Boston, MA\n - Seattle, WA\n - Charlotte, NC\n - Portland, OR\n - San Francisco, CA\n\n **Canada:**\n - Toronto, ON\n - Vancouver, BC\n - Montreal, QC\n - Calgary, AB\n - Ottawa, ON\n\n **Australia:**\n - Sydney, NSW\n - Melbourne, VIC\n - Brisbane, QLD\n - Perth, WA\n\n **United Kingdom:**\n - London\n - Birmingham\n - Manchester\n - Liverpool\n\n- **Q: Will it automatically follow all companies that I applied?**\n\n No, it will uncheck the follow option before submission by default.\n" }, { "path": "MAC_SETUP.md", "content": "## Setup on Apple Silicon (M1 to M3)\n\n1. **System Language**: Please make sure your macOS system language is set to **English**. (This ensures LinkedIn opens in English.)\n2. **Download**: Get the latest version here: [Download Link](https://github.com/lookr-fyi/job-application-bot-by-ollama-ai/releases/latest/download/JobHuntr-arm64.dmg)\n3. **Install:** Drag and drop the app into your **/Applications** folder.\n\n ![installer_image](src/installer_image.png)\n\n - If it doesn’t appear in Launchpad, open it via **Finder**.\n\n ![installer_image](src/where_find_it.png)\n\n4. **Login:** Launch the app, enter your LinkedIn email, and click **“Open LinkedIn.”** Sign in to your LinkedIn account in the browser window that opens. Since Chromium doesn’t allow Google OAuth, Please use email to sign in instead of google. Once you're logged in, the browser will close automatically, and you'll be redirected to the Jobhuntr home page.\n\n ![login_page](src/login.png)\n\n5. **Start Application:** Once you’ve filled in all the required fields marked in red, you’ll be ready to start your first application. Enjoy!\n\n ![setup_page](src/setup_page.png)\n" }, { "path": "PLATFORM_LETTER.md", "content": "# Open Letter to Career Platforms\n\nDear Career Platform Partners,\n\nWe are writing to you regarding JobHuntr.fyi, a tool designed to enhance the job-seeking experience while maintaining the integrity of your platforms. We believe in creating solutions that benefit all stakeholders in the hiring ecosystem - job seekers, employers, and platforms alike.\n\n## Our Approach\n\nJobHuntr.fyi is built with a fundamental principle: help job seekers focus on what truly matters while respecting platform guidelines and maintaining application quality. Our tool is not designed to flood your systems with low-quality applications, but rather to help candidates find and apply to positions where they are genuinely qualified and interested in the efficient way.\n\n## Commitment to Responsible Automation\n\nUnlike other automation tools that rely on massive offline web scraping, JobHuntr takes a fundamentally different approach. We have implemented several measures to ensure responsible use:\n\n- **Native Platform Integration**: We utilize your platform's built-in search features exactly as a human user would, but with an AI-powered semantic filtering layer.\n- **No Data Harvesting**: We don't mass scrape or store platform data beyond what's necessary for individual user applications\n- **Rate Limiting**: Built-in daily application limits to prevent platform flooding\n- **Human Oversight**: All applications can be reviewed by candidates before submission\n- **Platform Compliance**: Strict adherence to platform rules and guidelines\n- **Anti-Spam Measures**: Prevention of duplicate applications and automated detection of already-applied positions\n\n## Integration Possibilities\n\nWe are very interested in official integration opportunities with your platform. If you offer a Managed Client Program (MCP) or API access, we would be eager to:\n\n1. Integrate directly with your official APIs\n2. Implement any required rate limiting or compliance measures\n3. Work with your team to ensure our tool enhances rather than disrupts your ecosystem\n4. Share analytics and insights to help improve the job-seeking experience\n\n## Why This Benefits Everyone\n\nFor Job Seekers:\n\n- Focus on preparing for interviews rather than repetitive application tasks\n- Better job matches through intelligent filtering\n- More time for meaningful networking and skill development\n\nFor Platforms:\n\n- Higher quality applications\n- Controlled automation that respects your systems\n- Better user engagement through quality matches\n\nFor Employers:\n\n- More relevant candidate pool\n- Reduced screening time\n\n## Contact Us\n\nWe would welcome the opportunity to discuss how we can work together to improve the job-seeking experience while maintaining the integrity of your platform.\n\nPlease reach out to us at:\n\n- Email: hi@lookr.fyi\n- Website: https://jobhuntr.fyi\n\nBest regards,\nThe JobHuntr Team\n" }, { "path": "PRICING.md", "content": "# Pricing Plans\n\nYou can subscribe by clicking the subscribe button located on the top left corner of the app:\n\n![Subscribe](src/where_to_subscribe.png)\n\n## Pricing\n\n| Plan | Price | Billing Cycle |\n| ------- | ----- | ------------- |\n| Premium | $10 | Monthly |\n\n## Before You Pay\n\nBefore upgrading to Premium, consider these options to maximize your free usage:\n\n**Try Ollama Models First**: Test our Ollama models to evaluate if they meet your application quality requirements.\n\n## Feature Comparison\n\n| Feature | Premium | Free |\n| ----------------------- | --------------------------------- | -------- |\n| AI Model | GPT-4o + Claude 4 Sonnet | Ollama |\n| Activity Logs | Detailed with AI thinking process | Basic |\n| ATS Resume Generation | Automated per application | Manual |\n| Daily quota | 35-45 applications | 20 |\n| Cover Letter Generation | Automated per application | Manual |\n| Follow-up Connections | Automated with personalized notes | Manual |\n| Application Quality | Advanced | Standard |\n" }, { "path": "README.md", "content": "

\n\"JobHuntr\n

\n\n

\n\"Resume in. Interviews out — 100% Hand-free.\"\n

\n\n\n

\n \n \"Download\n \n \n \"Download\n \n

\n\nLatest Update: February 15, 2026 (v3.2.3)\n- LinkedIn Profile Audit: Get insights on your LinkedIn profile optimization.\n- ATS Resume Threshold: Set custom thresholds for automatic resume optimization.\n- Resume Upload from submission queue.\n\n✨ Improvements:\n- Fixed onboarding flow: Resume upload now works seamlessly for new users.\n- Enhanced resume display in submission queue.\n- Improved UI/UX across the application.\n- Better performance and stability.\n\nDecember 30, 2025 (v3.2.0)\n- Optimized company website search for faster and more reliable performance across career pages.\n- Company Career Page Apply: JobHuntr can now apply and submit resumes on any website across the internet, making it the first agent with truly universal job applications.\n- New Starter Plan: Starting at $9.99 for a low-friction way to get started immediately.\n- New Gigs feature: Short-term opportunities with third-party partners, with payment within one week. More partners coming soon.\n- As always, thank you for trusting us. Hope you are deleting JobHuntr soon\n\nDecember 8, 2025 (v3.0.0)\n- More Robust Infinite Hunt: Improved stability, smoother automation, and better long-run behavior.\n- 4 New Job Boards: Added based on community requests — thank you for the feedback!\n- AI Search on Company Career Sites: You can now search company career pages directly with AI. We might be the first in the market doing this — happy to be challenged :) Previously you needed your own LLM token for this feature; now it's fully covered by us.\n\nDecember 3, 2025 (v2.8.0)\n- D.A.M.N Mode (Done Applying, Market Nonsense): Run JobHuntr in headless mode so your browser won't disturb your workflow — especially useful for Mac users.\n- Community Job Board: See jobs discovered by other JobHuntr users within the last 24 hours, so you always catch the newest postings first.\n\nNovember 23, 2025 (v2.7.1)\n- Introduced Infinite Hunt so your bot scouts fresh roles around the clock.\n- Infinite Hunt can chain multiple agent runs for longer workflows.\n- Infinite Hunt automatically tunes its configuration after every run to surface stronger leads.\n\nNovember 13, 2025 (v2.5.0)\n- Introduced an autonomous agent that enables you to start job searches from any URL, automatically generates customized ATS-optimized resumes, and records applications in the job tracker.\n- Resolved various bugs and enhanced the overall user experience.\n- Added Indeed, ZipRecruiter, Glassdoor, and Dice support to keep your pipeline moving without hopping between tabs\n- New overview home page that summarizes your weekly activity, open workflows, and stalled applications in one glance\n- Rebuilt AI browser stack that rides directly inside your Chrome profile for better stealth and less frequent bot detection\n- Added a button to help you close the app once you got an offer :D\n\n## About JobHuntr.fyi\n\n

\n MacOS Tutorial •\n Windows Tutorial •\n FAQ •\n User Letter •\n Platform Letter •\n Pricing •\n TikTok\n

\n\n\n

\n \n \"Join\n Join our Slack Community\n \n

\n\n\nStepping into a new career can be extremely exhausting, but it doesn't have to be. JobHuntr is built to be a reliable and personalized AI agent, helping you get into the latest opportunities while you focus on what matters most. We put quality first—no BS, no spam.\n\n![JobHuntr Flowchart](src/flow_chart.png)\n\n## Demo\n\n[![JobHuntr Demo](https://img.youtube.com/vi/u5ETx8XXhYs/maxresdefault.jpg)](https://www.youtube.com/watch?v=u5ETx8XXhYs)\n\n\n\nClick to watch our demo video: [JobHuntr Demo](https://www.youtube.com/watch?v=u5ETx8XXhYs)\n\n## Features\n\n| Feature | Description |\n| ------------------------ | ------------------------------------------------------------------------------------- |\n| Generate ATS Resume | Generate ATS-optimized resume for each job application. |\n| Generate cover letter | Generate a personalized cover letter for all applications that require one. |\n| Submit high quality | Submit high quality answers, no spam. |\n| Iterative learning | Usually need review around 10, then you can let it free run. |\n| Auto Apply | Automatically applies to new jobs 24/7 in the background. |\n| Smart Filtering | Skips jobs that don't match your resume and custom filters. |\n| Company Blacklist | Exclude specific companies from job applications. Defaults to your past employers. |\n| Show References | Every answered question is backed by content from your resume or FAQs. |\n| Job Tracker | Track all your job applications and their status in one place. |\n| Progress Tracking | Saves application history and tracks which FAQs you've seen or answered. |\n| Skip Questions | Automatically skips optional or non-critical application questions. |\n| Pause/Resume | Start or stop the auto-apply agent at any time. |\n| Outreach to company | Send personalized messages to hiring managers, peers, and recruiters in the company after applying. |\n| AI Reasoning | View the AI's step-by-step decision-making for each application. |\n| Cloud AI | Uses a faster cloud-based AI model with improved matching and answering capabilities. |\n\n## Star Us\n\nWe need your help to increase the visibility of JobHuntr.fyi and enable more job seekers to land their dream jobs.\n\n![star_repo](src/star_repo.gif)\n\n## Contact\n\nWe'd love your feedback!\n\n📧 Email: hi@lookr.fyi\n" }, { "path": "USER_LETTER.md", "content": "# JobHuntr – A Letter from Us\n\nHi there!\n\nWe know—there are a lot of job tools out there. Boards, bots, extensions, AI this, AI that. It’s overwhelming. We’re not here to add to the noise. We’re building the job-hunting tool we wish we had: something that quietly works in the background, sending out smart, respectful applications while you focus on living your life.\n\nOur mission is clear - **Resume in, interview out, 100% hand-free.**\n\n## What JobHuntr Is (and Isn't)\n\nJobHuntr automates job applications on first-party sites like LinkedIn. We don’t generate resumes or try to tell you who you should be. We help you apply better and faster—without spamming platforms or bending the truth.\n\n- **✅ Personalized:** Smart filters and custom cover letters for each job.\n- **❌ Resume Generator:** That’s not our thing. We believe AI-made resumes often do more harm than good.\n- **🔜 What’s Next:** We’re expanding to cover more platforms like Indeed and beyond.\n\n## Feature Comparison\n\nHere are the alternative tools we compared with, and we encourage you to explore some of them to maximize your job application efficiency and chance of getting interviews:\n\n| Feature / Tool | **JobHuntr** | **Simplify** | **LazyApply** | **AIHawk** | **Huntr** | **Jobright** |\n| ---------------------------------------- | ------------ | ------------ | -------------- | -------------- | --------- | ------------ |\n| Hand-free Application Automation | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |\n| Autofill Extension | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ |\n| Personalized Cover Letter per job | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |\n| Smart Filtering | ✅ | ❌ | ✅ | ❌ | ❌ | ✅ |\n| Auto outreach to hiring managers | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |\n| Resume Builder | ❌ | ✅ | ❌ | ❌ | ✅ | ✅ |\n| Open Source | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |\n| Safe to use on platforms | ✅ | ✅ | ⚠️ Risk of Ban | ⚠️ Risk of Ban | ✅ | ✅ |\n| Automatically Refine Application Quality | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |\n| Basic Plan Cost | $10/month | $40/month | $8.3/month | Free | $40/month | $30/month |\n\nWhen it comes to platform safety, JobHuntr has a unique advantage: it operates directly from your own browser and IP address, significantly reducing the risk of detection. We also add human-like random delays between actions to mimic natural behavior. For more details, please see our Platform Letter.\n\nAs for cost, if you're using Ollama, you can run the bot locally—meaning no cloud fees, and the core functionality remains completely free.\n\n## When to Use JobHuntr\n\n⏳ You're short on time and tired of clicking “Apply” all day.\n\n🛠️ You want something that just works—no code, no hacks.\n\n🧘‍♂️ You care about staying under the platform's radar, not getting flagged.\n\n🌱 You want a steady stream of quality applications going out.\n\n💡 You believe respectful, thoughtful automation is possible.\n\n## Try It and Let Us Know\n\nJobHuntr is built for real job seekers. If it makes your search easier, we've done our job. And if it doesn’t, we genuinely want to hear from you—your feedback helps shape what we build next.\n\nThanks for giving us a shot.\n— From our small (but fast-moving) team with big ambitions ❤️\n" }, { "path": "WIN_SETUP.md", "content": "## Setup on Windows\n\n1. **System Language**: Please make sure your Windows system language is set to **English**. (This ensures LinkedIn opens in English.)\n\n2. **Download**: Get the latest version here: [Download Link](https://jobhuntr.fyi/download/windows)\n\n3. **Install**: \n - Run the downloaded `JobHuntr-Setup.exe` file\n - If you see a warning about \"Windows protected your PC\", click \"More info\" and then \"Run anyway\" (our apologies for the inconvenience!)\n \n ![Windows Warning](src/windows_unknown_publisher.png)\n - Follow the installation wizard\n - The application will be installed in your default Programs directory\n\n ![Windows Installer](src/windows_finish_install.png)\n\n4. **Login**: \n - Launch the app from your Start menu or desktop shortcut\n - Enter your LinkedIn email and click **\"Open LinkedIn\"**\n - Sign in to your LinkedIn account in the browser window that opens\n - Since Chromium doesn't allow Google OAuth, please use email to sign in instead of Google\n - Once you're logged in, the browser will close automatically, and you'll be redirected to the Jobhuntr home page\n\n ![Windows Login](src/login.png)\n\n5. **Start Application**: Once you've filled in all the required fields marked in red, you'll be ready to start your first application. Enjoy!\n\n ![Windows UI](src/windows_ui.png) " } ]