Search GitHub repositories for potential job candidates.

1. Gets all GitHub repositories with the specified minimum amount of stars for the given languages.
2. Gets commit count per user for each of those repositories.
3. Calculates a user's score as the sum of log(repoStars + 1) * commitCount over each repo.
4. Calculates a user's language distribution from the repo's language information.
5. Fetches user profile data.
6. Filters out users that don't match location filter or don't have an email address.
7. Prints a TSV table of all users, ranked by their score.

docker run \
  -e PEAKS_GITHUB_TOKENS="YOUR-GITHUB-PERSONAL-TOKEN-HERE1,YOUR-GITHUB-PERSONAL-TOKEN-HERE2" \
  -e PEAKS_LOCATIONS="lyon|marseille|rennes|tours" \
  -e PEAKS_LANGUAGES="Ruby|Go|PHP" \
  -e PEAKS_REPO_MIN_STARS="20000" \
  lucmichalski/peaks-seeker \
  > peaks-candidates.tsv

This examples looks for Ruby and Go developers in Berlin and San Francisco.

It only considers repositories with more than 20k stars. This is fast, but excludes a lot of data. You probably want to set this to a much lower number later on.

The output is a TSV list of user data, printed to STDOUT. Logging information is printed to STDERR.

The format is as follows:

Set the following environment variables to specify the configuration.

Then run the executable or use the docker image x0rzkov/seeker.

Make sure you have an up-to-date version of Go > 1.13.x installed.

Run make deps to install library dependencies. Run make build to build the executable.

See Makefile for more commands.

This tool does not send emails or contacts developers in any other way. It only outputs a list of publicly accessible user data from GitHub. Please use this tool responsibly and do not spam everybody!

Feel free to fork and submit Pull Requests!

MIT, see LICENSE.txt