strelov1/freehire
freehire — the open-source search engine for job seekers
freehire – 오픈소스 구직 및 지원 플랫폼
개요
- 기업 ATS(Workday, Greenhouse, Lever 등)와 채용 게시판에서 330만 개 이상의 실시간 IT 채용 공고를 직접 집계하고, 단일 스키마로 중복 제거한 후 패싯 검색 API를 제공하는 자체 호스팅 가능한 서비스입니다.
- 내장 AI 기능: 의미론적 채용 임베딩, 결정적 이력서-채용 점수화, LLM 기반 적합도 분석, 자동 이력서 맞춤화, Chrome 사이드 패널을 통해 탐색, 질문 응답, 면접 연습, 지원 양식 작성까지 가능한 앱 내 어시스턴트.
주요 기능
| 영역 | 제공 기능 |
|---|---|
| 찾기 | 전체 텍스트 + 패싯 검색(지역, 근무 형태, 경력, 기술, 급여). 큐레이션된 사전으로 신뢰할 수 있는 태그 보장. 이메일/텔레그램 다이제스트, 공유 보드, 시장 분석, '고스트 잡' 현실 신호가 포함된 저장 검색. |
| 지원 | ATS 안전 PDF 템플릿이 포함된 구조화된 이력서 편집기, 결정적 이력서↔채용 점수, 선택적 LLM 적합도 분석, 자동 양식 작성, 추적 링크, 추천 처리. |
| 추적 | 개인 지원 보드, 채용 담당자 답변을 올바른 지원에 연결하는 메일 수신함, 추가 전용 이벤트 원장, 알림. |
| 질문 | 프로세스 내 AI 어시스턴트(채팅, 탐색, 프로필, 이력서 맞춤화, 면접 연습). API 키를 노출하지 않고 실행. |
| 확장 | 공개 키 없는 HTTP API, Go CLI, Claude Desktop/Code용 MCP 서버, 브라우저 확장, ChatGPT Actions. |
아키텍처 개요
- 백엔드: Go + Fiber HTTP 서버, 의미 벡터용 PostgreSQL + pgvector, 빠른 패싯 검색용 Meilisearch, 속도 제한 및 실시간 팬아웃용 Redis, 이력서 자산용 S3 호환 스토리지.
- AI 계층: OpenAI 호환 LLM용
langchaingo, 사용자별 가상 키 및 지출 추적용Bifrost, 호출 추적용Langfuse, 강화 및 적합도 분석용 선택적 LLM 엔드포인트. - 프론트엔드:
web/아래 서버 렌더링 SvelteKit 2 앱(Tailwind). - 워커: 크롤링(
ingest), 강화(LLM), 임베딩, 검색 인덱싱, 텔레그램 채널 추출, 양식 캡처 등을 처리하는 별도의 cron 스타일 Go 바이너리. - 배포: Docker Compose로 API, 웹 UI, Postgres, Meilisearch, Redis, S3 스텁을
make up한 번으로 시작.
시작하기(로컬)
# 클론, env 템플릿 복사 및 모든 서비스 시작
cp .env.example .env
make up # 모든 컨테이너 빌드 및 실행
curl localhost:8080/health # 헬스 체크
curl localhost:8080/api/v1/jobs # 샘플 API 호출
- 개별 워커는
go run ./cmd/<worker>로 실행(예:ingest greenhouse). - 스키마 변경 후
make reindex로 Meilisearch 인덱스 재구축.
일반적인 사용 사례
- 구직자: 깨끗하고 최신의 카탈로그를 검색하고, AI 강화 매치 점수를 받고, 어시스턴트가 이력서를 맞춤화하고 지원서를 자동으로 작성하도록 합니다.
- 개발자/스타트업: 리포지토리를 포크하여 자체 인스턴스를 호스팅하거나 공개 API 위에 맞춤 서비스(예: 틈새 채용 알림 봇, 분석 대시보드)를 구축합니다.
- 채용 담당자/HR 테크: 오픈 데이터 파이프라인을 내부 도구에 활용하거나 이력서 매칭 엔진을 기존 지원자 추적 워크플로에 통합합니다.
커뮤니티 및 기여
- MIT 라이선스, 새 소스(한 줄 YAML 보드 항목) 또는 새 ATS 어댑터 기여를 환영합니다.
- Discord, GitHub Issues/PRs에서 토론, 라이브 사이트에 '보드 기여' 양식.
- Prometheus + Grafana로 모니터링, LLM 사용량은 사용자별로 추적.
더 알아보기
- 라이브 데모: https://freehire.me
- API 문서: https://freehire.me/docs/api
- 아키텍처 세부 사항:
docs/architecture.md - 기능 목록:
docs/features.md
freehire는 대규모 실시간 채용 집계와 현대적인 LLM 기반 지원을 결합한 풀스택 오픈소스 플랫폼으로, 모두 관대한 MIT 라이선스 하에 제공됩니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트