npm Global Install
Install StudentSync directly from npm as a global binary. Recommended if you already manage your own process supervisor.
Install
bash
npm install -g studentsyncThis adds the studentsync binary to your globalnpm bin directory (usually /usr/local/bin on macOS / Linux).
Run the onboarding wizard
bash
studentsync onboardThe wizard writes .env and .config/scholar.json to your home directory. See Onboarding Wizard for the full list of prompts.
Run in the foreground
Useful when you want to watch logs flow in real time, or while debugging a new LLM provider:
bash
studentsyncRun as a daemon (PM2)
The recommended way to keep StudentSync up 24/7:
bash
npm install -g pm2pm2 start studentsync --name student-daemonpm2 savepm2 startup # generates the OS-level startup hookOn Windows, use pm2-windows-startup instead of
pm2 startup.Upgrade
bash
npm install -g studentsync@latestpm2 restart student-daemonRelease cadence
Releases are cut automatically from
main on every tagged commit via GitHub Actions with NPM provenance.