Getting Started with opengrasp
opengrasp is an open-source, privacy-first, terminal-first job application assistant. It runs 100% locally — your CV never leaves your machine.
01Install
Install opengrasp from PyPI:
$pip install opengrasp
02Setup
Run setup to create your config files and local database:
$opengrasp setup
This creates portals.yml and data/opengrasp.db.
03Enable a Portal & Scan
Open portals.yml and set at least one entry to active: true, then:
$opengrasp doctor
$opengrasp scan --limit 5 --link-limit 30
04What's Next?
Set Up Ollama Models
Install local models for evaluation and generation
Configure Portals
Enable job portals in portals.yml
Run the Full Pipeline
Scan, score, tailor CV, and draft application
Understand HITL
Why opengrasp never auto-submits applications