Summary

CareerPilot is a self-hosted AI-powered career assistant designed to manage job searching activities, including tracking target companies, public career URLs, job leads, applications, and interview preparation. It offers a centralized platform for users to streamline their career management workflow, enhancing efficiency and organization.

How It Works

The system employs a full-stack architecture featuring a Kotlin/Ktor backend, a React/Vite frontend, and Python scripting for automation tasks. It integrates with user-configured Large Language Models (LLMs) via .env secrets for AI-driven features like interview plan generation. Data flows from user-defined public career pages to application tracking and weekly reporting, utilizing MySQL as the primary database.

Quick Start & Requirements

Installation is recommended via Docker Compose (docker compose up --build -d). Prerequisites include Docker v2, JDK 21, Node.js 18+ (20+ recommended), and Python 3.11+. Users must configure secrets, including JWT_SECRET, in a .env file (copied from .env.example). Detailed setup guides are available in docs/local-setup.md and docs/ai-setup.md.

Highlighted Details

• Self-hosted, privacy-focused AI career management solution.
• Automates tracking of target companies, job leads, and application statuses.
• AI-driven interview plan generation and weekly reporting capabilities.
• Supports configuration of public career page URLs and various LLM providers (including a mock mode).

Maintenance & Community

Project context and maintainer handoff rules are detailed in PROJECT_CONTEXT.md. No specific community channels or active contributor highlights are present in the README.

Licensing & Compatibility

Distributed under the MIT License, permitting broad use and modification. Compatibility is focused on self-hosted deployments; specific integrations with third-party job boards requiring authentication are explicitly not supported.

Limitations & Caveats

The project explicitly does not support automation for major platforms like LinkedIn, Indeed, or Glassdoor, nor does it handle login-gated job boards or sites with strict scraping policies. Users must manage LLM API keys and secrets securely in the .env file, which is gitignored.