pyr0ball
8cb636dabe
Adds a full MkDocs documentation site under docs/ with Material theme. Getting Started: installation walkthrough, 7-step first-run wizard guide, Docker Compose profile reference with GPU memory guidance and preflight.py description. User Guide: job discovery (search profiles, custom boards, enrichment), job review (sorting, match scores, batch actions), apply workspace (cover letter gen, PDF export, mark applied), interviews (kanban stages, company research auto-trigger, survey assistant), email sync (IMAP, Gmail App Password, classification labels, stage auto-updates), integrations (all 13 drivers with tier requirements), settings (every tab documented). Developer Guide: contributing (dev env setup, code style, branch naming, PR checklist), architecture (ASCII layer diagram, design decisions), adding scrapers (full scrape() interface, registration, search profile config, test patterns), adding integrations (IntegrationBase full interface, auto- discovery, tier gating, test patterns), testing (patterns, fixtures, what not to test). Reference: tier system (full FEATURES table, can_use/tier_label API, dev override, adding gates), LLM router (backend types, complete() signature, fallback chains, vision routing, __auto__ resolution, adding backends), config files (every file with field-level docs and gitignore status). Also adds CONTRIBUTING.md at repo root pointing to the docs site.
4.8 KiB
Settings
The Settings page is accessible from the sidebar. It contains all configuration for Peregrine, organised into tabs.
My Profile
Personal information used in cover letters, research briefs, and interview prep.
| Field | Description |
|---|---|
| Name | Your full name |
| Contact email address | |
| Phone | Contact phone number |
| LinkedIn profile URL | |
| Career summary | 2–4 sentence professional summary |
| NDA companies | Companies you cannot mention in research briefs (previous employers under NDA) |
| Docs directory | Where PDFs and exported documents are saved (default: ~/Documents/JobSearch) |
Mission Preferences
Optional notes about industries you genuinely care about. When the cover letter generator detects alignment with one of these industries, it injects your note into paragraph 3 of the cover letter.
| Field | Tag | Example |
|---|---|---|
| Music industry note | music |
"I've played in bands for 15 years and care deeply about how artists get paid" |
| Animal welfare note | animal_welfare |
"I volunteer at my local shelter every weekend" |
| Education note | education |
"I tutored underserved kids and care deeply about literacy" |
Leave a field blank to use a generic default when alignment is detected.
Research Brief Preferences
Controls optional sections in company research briefs. Both are for personal decision-making only and are never included in applications.
| Setting | Section added |
|---|---|
| Candidate accessibility focus | Disability inclusion and accessibility signals (ADA, ERGs, WCAG) |
| Candidate LGBTQIA+ focus | LGBTQIA+ inclusion signals (ERGs, non-discrimination policies, culture) |
Search
Manage search profiles. Equivalent to editing config/search_profiles.yaml directly, but with a form UI.
- Add, edit, and delete profiles
- Configure titles, locations, boards, custom boards, exclude keywords, and mission tags
- Changes are saved to
config/search_profiles.yaml
LLM Backends
Configure which LLM backends Peregrine uses and in what order.
| Setting | Description |
|---|---|
| Enabled toggle | Whether a backend is considered in the fallback chain |
| Base URL | API endpoint (for openai_compat backends) |
| Model | Model name or __auto__ (vLLM auto-detects the loaded model) |
| API key | API key if required |
| Test button | Sends a short ping to verify the backend is reachable |
Fallback chains
Three independent fallback chains are configured:
| Chain | Used for |
|---|---|
fallback_order |
Cover letter generation and general tasks |
research_fallback_order |
Company research briefs |
vision_fallback_order |
Survey screenshot analysis |
Notion
Configure Notion integration credentials. Requires:
- Notion integration token (from notion.so/my-integrations)
- Database ID (from the Notion database URL)
The field map controls which Notion properties correspond to which Peregrine fields. Edit config/notion.yaml directly for advanced field mapping.
Services
Connection settings for local services:
| Service | Default host:port |
|---|---|
| Ollama | localhost:11434 |
| vLLM | localhost:8000 |
| SearXNG | localhost:8888 |
Each service has SSL and SSL-verify toggles for reverse-proxy setups.
Resume Profile
Edit your parsed resume data (work experience, education, skills, certifications). This is the same data extracted during the first-run wizard Resume step.
Changes here affect all future cover letter generations.
Configure IMAP email sync. See Email Sync for full setup instructions.
Skills
Manage your config/resume_keywords.yaml — the list of skills and keywords used for match scoring.
Add or remove keywords. Higher-weighted keywords count more toward the match score.
Integrations
Connection cards for all 13 integrations. See Integrations for per-service details.
Fine-Tune
Tier: Premium
Tools for fine-tuning a cover letter model on your personal writing style.
- Export cover letter training data as JSONL
- Configure training parameters (rank, epochs, learning rate)
- Start a fine-tuning run (requires
ogmaconda environment with Unsloth) - Register the output model with Ollama
Developer
Developer and debugging tools.
| Option | Description |
|---|---|
| Reset wizard | Sets wizard_complete: false and wizard_step: 0; resumes at step 1 on next page load |
| Dev tier override | Set dev_tier_override to paid or premium to test tier-gated features locally |
| Clear stuck tasks | Manually sets any running or queued background tasks to failed (also runs on app startup) |
| View raw config | Shows the current config/user.yaml contents |