🐸 Amphib is built on Hiring Agent by HackerRank — and we're making it better.

Setup

Prerequisites

Install

git clone <your-repo-url> && cd amphib
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

Pull a model

ollama pull gemma3:4b      # balanced
ollama pull gemma3:12b     # more capable
ollama pull gemma3:1b      # lightweight

Configure

cp .env.example .env

Edit .env:

Variable Values Description
LLM_PROVIDER ollama or gemini Backend choice
DEFAULT_MODEL e.g. gemma3:4b Model name
GEMINI_API_KEY string Required for Gemini
GITHUB_TOKEN string Optional — higher API rate limits

Run

python score.py /path/to/resume.pdf

That's it. Amphib will parse, enrich, and print a scored evaluation.