An open-source hiring platform to streamline recruitment and hire faster.

Live demo · Features · Tech stack · Getting started · Configuration · Contributing

OpenATS is an open-source applicant tracking system for organizations that want to run hiring in one clear, shared workspace. It replaces disconnected spreadsheets, inboxes, and point tools with a process that follows a candidate from an open role through interview and final decision.

• Jobs and careers page: create jobs with departments, salary and custom application questions, and publish them on a built-in careers page or embed them on your own website.
• Candidate pipeline: move candidates through your own hiring stages on a drag and drop board, with filters, bulk actions and a full stage history.
• CV search: the text of every uploaded CV is read on your server, so you can search across all CVs and see where the words matched.
• Scoring: each job sets how much application answers, assessments, ratings and interviews count, and every candidate gets a total score from them.
• Assessments: build tests with choice and written questions, send them automatically at a stage, and grade written answers.
• Interviews: schedule interviews, let candidates pick a time from the slots you offer, add them to the interviewer's Google Calendar with a Meet link, and collect scorecards.
• Offers: write offer letters from templates, send them, and let candidates accept or decline online before the offer expires.
• Emails: email candidates from templates, and reword the emails OpenATS sends by itself.
• Team collaboration: a private discussion for each job's hiring team, star ratings and shared notes.
• Roles and access: super admins, hiring managers and interviewers, with interviewers seeing only the jobs they are on.
• Optional AI notes: turn on Gemini to get a summary, strengths and gaps for each CV. It is off by default and never part of the score.

One pnpm workspace with two packages, frontend and backend, installed from the root.

You need Node.js 22+, Docker, pnpm (npm install -g pnpm), make and openssl.

git clone https://github.com/chamals3n4/OpenATS.git && cd OpenATS

make setup   # installs, creates both .env files, starts Postgres and Redis,
             # runs migrations, seeds the pipeline stages, creates your first admin
make dev     # API on :8080, worker, and the app on :3000

Open http://localhost:3000 and sign in with the admin you created. Run make admin at any time to add a super admin, or to get back in if you are locked out.

A few values can't be generated for you: fill in R2_* and RESEND_* in backend/.env before uploading CVs or sending email.

The background worker is required. It reads every uploaded CV and removes the files of deleted candidates; without it, CVs stay "pending". make dev starts it with everything else. To turn on AI notes, set GEMINI_API_KEY and enable it in Settings → General.

For every step done by hand, see CONTRIBUTING.md.

Each package reads its own .env, and each .env.example explains every value. Both apps stop at startup with a clear message if a required value is missing.

backend/.env

frontend/.env

See CONTRIBUTING.md for the full setup, branching rules and how to open a pull request.

Apache 2.0.