GeekGeekRun is an open-source, free automation tool designed to streamline the job-seeking process on Boss Zhipin. It targets job seekers by automating repetitive tasks like initiating conversations with potential employers, reminding them of unread messages, and filtering irrelevant job postings, aiming to reduce the mental overhead and improve efficiency in finding suitable employment.

How It Works

The tool operates by leveraging Puppeteer to automate interactions within the Boss Zhipin web interface. Its core features include "Boss Bomb" for mass outreach based on user-defined preferences, automatically initiating chats with suitable employers. It also features a "Read-Unread Reminder" that re-engages employers who haven't responded, using either a predefined emoji or AI-generated messages based on user resumes and chat context. The system intelligently filters out inactive or unsuitable job listings by marking them as "unsuitable," aiming to present a cleaner, more relevant job feed.

Quick Start & Requirements

• Installation: Download the latest release from https://github.com/geekgeekrun/geekgeekrun/releases and run the installer (.exe for Windows, .deb for Linux, .dmg for macOS).
• Prerequisites: Windows 10 (x86_64), Ubuntu 20.04 (x86_64) with desktop environment, or macOS Sonoma 14.0 (Apple Silicon, x86_64).
• Setup: Post-installation, the application guides users through initial configuration.
• AI Features: Requires users to obtain API keys and configure their preferred large language models separately.

Highlighted Details

• Automates initiating conversations with employers ("Boss Bomb").
• Reminds employers of unread messages with AI-generated follow-ups.
• Filters out "zombie" or unsuitable job postings.
• Includes a Boss login assistant for simplified authentication.

Maintenance & Community

The project is actively developed by geekgeekrun. Further community engagement details (Discord/Slack, roadmap) are not explicitly provided in the README.

Licensing & Compatibility

The project is explicitly stated as "completely open-source, free." Specific license details (e.g., MIT, Apache) are not mentioned, but the emphasis on being free and open-source suggests broad compatibility for personal use. Commercial use implications are not detailed.

Limitations & Caveats

The macOS installation requires manual terminal commands to bypass security restrictions due to unsigned distribution packages. The effectiveness of AI-generated messages depends on the quality of user-provided resume data and the chosen LLM. Compatibility with Linux distributions other than Ubuntu 20.04 and older macOS versions is not tested.