Eggtray 🥚

Entry level candidates API

Add yourself

If you're looking for an entry level software engineering job, send a Pull Request adding a new YAML file (RealPython has a good intro to YAML) to the ./profiles directory. Each YAML file in that directory represents a profile of a single person:

• Name of the file must be your GitHub username
• The file must have the .yml extension
• See the YAML existing files, models.py, and enums.py to learn about the format of the YAML document
• If your skills are missing in the Skill enum, feel free to add them
• Members of the junior.guru club can use /discord_id on Discord to learn what's their Discord ID

Once the PR gets accepted, Eggtray uses Hen to inspect your GitHub profile. It merges the findings with data from the YAML file and creates a single data structure, which is then available in the API as your profile information.

If you want to change something in the YAML, send another PR. If you found a job (congratulations!) and now want to remove yourself from the API, send a PR removing your YAML file.

Note

The API updates only once a day. If you change someting on your GitHub profile or in your YAML file, it can take up to 24 hours to take effect in the API.

API usage

Open juniorguru.github.io/eggtray/profiles.json. That's it! As of now, there are no limitations on what you can do with the API. You can use the data for any purpose, even commercial, and there is no rate limiting.

The API has been created for the purpose of listing entry level candidates on junior.guru/candidates, but is open to anyone. If you use the API, file an issue and let's link your project from this document.

Caution

As of now, the API is extremely UNSTABLE. There are no guarantees on schema of the response. Anything can and will change over night.

Regular profile checks

Every night, each profile is reviewed. If the review uncovers any serious shortcomings, a GitHub issue labeled profile not ready is created, listing the identified issues and notifying the profile owner. The profile is then demoted in the junior.guru/candidates listing.

Once the shortcomings are resolved, a subsequent nightly check automatically closes the issue, and after the junior.guru website updates, the profile is promoted in the juniors listing again.

One-off profile checks

This repository also provides one-off GitHub profile checks as a service. File a new issue with the check template, and a bot will review your profile. You'll see the results in the comments under the issue. Once the check is done, the bot closes the issue.

License

AGPL-3.0-only, copyright (c) 2025 Jan Javorek, and contributors.