Installation

Requirements

• Python 3.11 or newer.
• A host coding CLI — Claude Code, Codex, Gemini CLI, or OpenCode. The host agent runs the reasoning steps.
• A Fantastic Jobs API key for the default paid source. The two free sources (RemoteOK, We Work Remotely) need no signup.

The last two are not installed by pip — a host CLI and an API key are things you bring.

Install

$ git clone https://github.com/vbkatarnaware/careeros
$ cd careeros
$ pip install -e .

Optional extras

Each extra is opt-in. A fresh clone runs the daily pipeline without any of them.

# Google Drive backup + PDF rendering
$ pip install -e ".[drive,pdf]"
 
# Background form-reading for Application Answers (JS-only forms)
$ pip install -e ".[apply]"
$ playwright install chromium
 
# The test suite
$ pip install -e ".[dev]"

Confirm your setup

careeros doctor is a read-only first-run checklist. It checks your Python version, profile, discovery credentials, Sheets, Drive, and Playwright — and tells you exactly what's missing. It never modifies anything.

$ careeros doctor

Scaffold your workspace

careeros init creates the local .careeros/ directory with a config file and an example profile. Everything CareerOS writes lives under this folder, and it's gitignored.

$ careeros init