Create

Sign in to ReadmeX

or

How we handle your data: Privacy Policy

ReadmeX

Your AI reading companion

What would you like to catch up on?

Pick a briefing, or ask your own question.

Your community and people briefings stay personal to you.

freehire

freehire• Pinned

freehire: An open-source search engine for job seekers.

What problem it solves

Job seekers often encounter duplicate listings, recruiter reposts, and links that no longer lead to the original posting. freehire addresses this by crawling company and platform sources, normalizing postings into a shared schema, deduplicating repeated roles, and linking results back to their source.

Key features

  • Source-based job ingestion — Listings are collected from company applicant-tracking systems, job boards, and direct company feeds. Each result is linked to the original posting.

    Source: README, cmd

  • Normalized and deduplicated catalogue — Postings from multiple sources are transformed into a common schema and collapsed when they represent the same role. Stable fingerprints and related pipeline packages support this processing.

    Source: README

  • Faceted job search — Search covers job text and structured facets including region, work mode, seniority, skills, and salary. Facet values come from curated dictionaries rather than being guessed.

    Source: README

  • Self-hostable open platform — The MIT-licensed project can be hosted independently, and its ingestion pipeline and catalogue are open for inspection and extension. Local development uses Docker Compose for the application services.

    Source: README

  • API and integration surfaces — The catalogue is exposed through a keyless public HTTP API, with additional CLI, MCP server, browser extension, and ChatGPT Actions mentioned as ways to build on it.

    Source: README

Quick start

Copied verbatim from the project's README.

make up        # build + start the whole stack in Docker:
               # api, web, postgres, meilisearch, redis, s3
curl localhost:8080/health
curl localhost:8080/api/v1/jobs

Who it may suit

This may suit job seekers who want source-linked listings, structured filters, and application tracking in one self-hostable interface. It may also suit developers who want to contribute source adapters or build job-search workflows on the catalogue.

Topics to discuss

  • Which additional ATS adapters or company source feeds would be most useful to support next?

  • How can the normalized posting schema better support application tracking and recruiter replies?

  • Which self-hosting, API, or extension workflows need clearer documentation for contributors and users?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/strelov1/freehire#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.

github.comhttps://github.com/strelov1/freehire

Comments

…