job_pilot - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #llm #go #android #machine-learning #rust #macos #nodejs #java #vue #pytorch

job_pilot

(★ 124)

AI-powered job search assistance for matching roles, tailored resumes, and faster applications.

파일 탐색기

최종 버전 다운로드 (.zip)

- profile.ts
- research.ts
- - page.tsx
- - page.tsx
- - page.tsx
- favicon.ico
- globals.css
- layout.tsx
- page.tsx
- - PostHogIdentify.tsx
  - PostHogLogoutLink.tsx
- - LoginCard.tsx
- - AnalyticsCharts.tsx
  - RecentActivity.tsx
  - StatsBar.tsx
- - FindJobsClient.tsx
  - JobFilters.tsx
  - JobsPagination.tsx
  - JobsTable.tsx
  - SearchControls.tsx
- - CTASection.tsx
  - Features.tsx
  - Hero.tsx
  - HowItWorks.tsx
  - SuccessStory.tsx
- - CompanyResearch.tsx
  - JobActions.tsx
  - JobDescription.tsx
  - JobInfo.tsx
  - MatchScore.tsx
  - ResearchCompanyButton.tsx
- - Footer.tsx
  - Logo.tsx
  - Navbar.tsx
- - ConnectedAccounts.tsx
  - ProfileAttentionBanner.tsx
  - ProfileForm.tsx
  - ProfilePageClient.tsx
  - ResumeSection.tsx
- - Dashboard.png
  - find-jobs.png
  - job-details.png
  - landing-page.png
  - profile.png
- architecture.md
- build-plan.md
- code-standards.md
- library-docs.md
- progress-tracker.md
- project-overview.md
- ui-registry.md
- ui-rules.md
- ui-tokens.md
- adzuna.ts
- auth.ts
- browserbase.ts
- insforge-client.ts
- insforge-server.ts
- posthog-client.ts
- posthog-server.ts
- profile-utils.ts
- utils.ts
- 20260603114532_create-profiles.sql
- 20260603114534_create-agent-runs.sql
- 20260603114535_create-jobs.sql
- 20260603114536_create-agent-logs.sql
- 20260603114724_create-storage-rls.sql
- 20260605000000_add-company-research-to-jobs.sql
- - agnet-log.png
  - dashboard-demo.png
  - jobs-lists.png
  - user-icon.png
- - image (1).webp
  - jsm-icon.webp
  - jsm-thumbnail.webp
  - readme-hero.webp
  - readme-jsmpro.webp
  - readme-videokit.webp
  - thumbnail.webp
- - thumbnail (1).jpg
  - thumbnail (1).png
  - thumbnail (2).jpg
  - thumbnail (3).png
  - thumbnail (4).png
- logo.png
- index.ts
.env.example
.gitignore
.posthog-events.json
AGENTS.md
CLAUDE.md
eslint.config.mjs
instrumentation-client.ts
memory.md
next.config.ts
package-lock.json
package.json
postcss.config.mjs
proxy.ts
README.md
skills-lock.json
szbrrwnrfksk.pdf
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <br />
    <a href="https://youtu.be/9dKA2hq4vf0" target="_blank">
      <img src="public/readme/readme-hero.webp" alt="Project Banner">
    </a>
  <br />

<div>
<img src="https://img.shields.io/badge/-Next.js-black?style=for-the-badge&logo=Next.js&logoColor=white" />
<img src="https://img.shields.io/badge/-TypeScript-3178C6?style=for-the-badge&logo=TypeScript&logoColor=white" />
<img src="https://img.shields.io/badge/-Tailwind%20CSS-06B6D4?style=for-the-badge&logo=Tailwind%20CSS&logoColor=white" />
<img src="https://img.shields.io/badge/-shadcn%2Fui-000000?style=for-the-badge&logo=shadcnui&logoColor=white" />
<br />
<img src="https://img.shields.io/badge/-OpenAI%20GPT--4o-412991?style=for-the-badge&logo=OpenAI&logoColor=white" />
<img src="https://img.shields.io/badge/-Stagehand-orange?style=for-the-badge" />
<img src="https://img.shields.io/badge/-Browserbase-000000?style=for-the-badge" />
<img src="https://img.shields.io/badge/-InsForge-darkgreen?style=for-the-badge" />

</div>

<h3 align="center">JobPilot | Match-tracking AI Agent</h3>

<div align="center">
     Build this project step by step with our detailed tutorial on <a href="https://www.youtube.com/watch?v=XUkNR-JfHwo" target="_blank"><b>JavaScript Mastery</b></a> YouTube. Join the JSM family!
    </div>
</div>
 
## 📋 <a name="table">Table of Contents</a>

1. ✨ [Introduction](#introduction)
2. ⚙️ [Tech Stack](#tech-stack)
3. 🔋 [Features](#features)
4. 🤸 [Quick Start](#quick-start)
5. 🔗 [Assets](#links)
6. 🚀 [More](#more)

## 🚨 Tutorial

This repository contains the code corresponding to an in-depth tutorial available on our YouTube channel, <a href="https://www.youtube.com/@javascriptmastery/videos" target="_blank"><b>JavaScript Mastery</b></a>.

If you prefer visual learning, this is the perfect resource for you. Follow our tutorial to learn how to build projects like these step-by-step in a beginner-friendly manner!

<a href="https://youtu.be/9dKA2hq4vf0" target="_blank"><img src="https://github.com/sujatagunale/EasyRead/assets/151519281/1736fca5-a031-4854-8c09-bc110e3bc16d" /></a>

## <a name="introduction">✨ Introduction</a>

JobPilot is an autonomous, full-stack AI agent that transforms how technical job seekers find work by simultaneously browsing LinkedIn, Wellfound, and YC Jobs to discover, score, and apply to roles. Powered by Next.js, GPT-4o, and Browserbase/Stagehand automation, the app dynamically customizes resumes and executes real browser application forms autonomously. More than just a utility, JobPilot serves as a masterclass in modern agentic engineering, utilizing five core open-source skills—/architect, /remember, /review, /recover, and /imprint—to demonstrate how a single developer with a structured system can rapidly ship durable, production-grade AI software.

An experimental Browserbase/Stagehand apply path is included for review — see [BROWSERBASE_REPORT.md](BROWSERBASE_REPORT.md) for full details on what was attempted and where it currently stands.

If you're getting started and need assistance or face any bugs, join our active Discord community with over **50k+** members. It's a place where people help each other out.

<a href="https://discord.com/invite/n6EdbFJ" target="_blank"><img src="https://github.com/sujatagunale/EasyRead/assets/151519281/618f4872-1e10-42da-8213-1d69e486d02e" /></a>

## <a name="tech-stack">⚙️ Tech Stack</a>

- **[Next.js](https://nextjs.org/)** is a full-stack React framework that powers JobPilot's user interface, utilizing the App Router, Server Actions, and API Routes to deliver server-rendered components and high-performance client-side navigation.
- **[TypeScript](https://www.typescriptlang.org/)** is a strongly typed programming language that builds on JavaScript, ensuring strict type safety across the entire codebase and providing a maintainable environment for complex agent orchestration.
- **[Tailwind v4](https://tailwindcss.com/)** is a utility-first CSS framework used for rapid UI development, providing a clean, responsive, and easily customized styling infrastructure.
- **[shadcn/ui](https://ui.shadcn.com/)** is a collection of re-usable UI components built using Radix Primitives and Tailwind CSS, serving as the design system for the app's dashboard, tables, and job inventory views.
- **[OpenAI GPT-4o](https://openai.com/)** is a highly capable multimodal AI model that serves as the core intelligence engine, parsing job descriptions to compute match scores, tailoring resumes, and driving the form-filling automation logic.
- **[Stagehand](https://github.com/browserbase/stagehand)** is an AI-driven browser agent built on top of Playwright that uses LLMs to interpret page elements dynamically, allowing JobPilot to execute LinkedIn Easy Apply paths and handle external ATS form-filling.
- **[Browserbase](https://www.browserbase.com/)** is a headless cloud browser platform that manages infrastructure, session persistence, authentication states, and CAPTCHA solving so background jobs can run through realistic browser instances.
- **[InsForge](https://insforge.com/)** is a comprehensive backend-as-a-service provider that supplies the relational PostgreSQL database to manage the job inventory, handles user authentication, and provides secure file storage for assets.
- **[PostHog](https://posthog.com/)** is an all-in-one product analytics platform used to track user engagement, system performance metrics, and the success rates of automated application paths.

## <a name="features">🔋 Features</a>

👉 **LinkedIn Job Discovery**: Authenticated LinkedIn search utilizing a saved Browserbase context session to fetch job titles, companies, locations, and source/apply URLs automatically.

👉 **Match Scoring**: Advanced evaluation where each discovered job is parsed and scored against your professional profile by an LLM, then ranked by match percentage.

👉 **Job Inventory**: A central, filterable dashboard table that organizes matched jobs with quick access to source links, external apply links, application types, and real-time status.

👉 **Job Details**: A dedicated, per-job review view featuring a transparent match breakdown, full descriptions, direct resume controls, and manual apply triggers.

👉 **Resume Generation & Tailoring**: Dynamic engine that generates a foundational resume from your user profile, then instantly customizes it to target specific job descriptions.

👉 **LinkedIn Easy Apply**: An experimental, automated application path utilizing saved LinkedIn session contexts and Stagehand DOM mode to submit applications directly.

👉 **External Apply Attempt**: An experimental, hybrid-mode browser path powered by Stagehand designed to navigate complex external ATS forms and complete inputs autonomously.

👉 **Session Recordings**: Complete transparency layer that links every automated application attempt to a Browserbase video recording URL for auditing and debugging.

And many more, including code architecture and reusability.

## <a name="quick-start">🤸 Quick Start</a>

Follow these steps to set up the project locally on your machine.

**Prerequisites**

Make sure you have the following installed on your machine:

- [Git](https://git-scm.com/)
- [Node.js](https://nodejs.org/en)
- [npm](https://www.npmjs.com/) (Node Package Manager)

**Cloning the Repository**

```bash
git clone https://github.com/adrianhajdin/job_pilot.git
cd job_pilot
```

**Installation**

Install the project dependencies using npm:

```bash
npm install
```

**Set Up Environment Variables**

Create a new file named `.env` in the root of your project and add the following content:

```env
NEXT_PUBLIC_INSFORGE_URL=https://9zb7h4wq.us-east.insforge.app
NEXT_PUBLIC_INSFORGE_ANON_KEY=

NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com

OPENAI_API_KEY=

BROWSERBASE_API_KEY=
BROWSERBASE_PROJECT_ID=

ADZUNA_APP_ID=
ADZUNA_APP_KEY=
```

Replace the placeholder values with your real credentials. You can get these by signing up at: [**InsForge**](https://insforge.dev/), [**Browserbase**](https://www.browserbase.com/), [**OpenAI**](https://platform.openai.com/), [**PostHog**](https://posthog.com/), [**Adzuna**](https://www.adzuna.com/)
**Running the Project**

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000) in your browser to view the project.

**How It Works**

1. **Set up your profile** — fill in your experience, skills, target role, salary expectations, and upload a base resume PDF
2. **Connect LinkedIn** — save a LinkedIn browser session via Browserbase so job discovery can run authenticated
3. **Find Jobs** — the agent searches LinkedIn for roles matching your target, scores each one, and saves strong matches to your job inventory
4. **Review matches** — browse the `/jobs` list, click into any role for the full description, match breakdown, and apply links
5. **Tailor and apply** — generate a tailored resume for a specific role, then use the apply links directly or trigger the experimental Browserbase apply attempt

**Browserbase Integration**

See BROWSERBASE_REPORT.md for a detailed report on how Browserbase and Stagehand are used in this project, including the full history of the apply automation experiments and the current project state.

**Deploy on Vercel**

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.

Check out the [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

## <a name="links">🔗 Assets</a>

Assets and snippets used in the project can be found in the **[video kit](https://jsm.dev/jobpilot-kit)**.

<a href="https://jsm.dev/jobpilot-kit" target="_blank">
  <img src="public/readme/readme-videokit.webp" alt="Video Kit Banner">
</a>

## <a name="more">🚀 More</a>

**Advance your skills with our Pro Course**

Enjoyed creating this project? Dive deeper into our PRO courses for a richer learning adventure. They're packed with
detailed explanations, cool features, and exercises to boost your skills. Give it a go!

<a href="https://jsm.dev/jobpilot-jsm" target="_blank">
  <img src="public/readme/readme-jsmpro.webp" alt="Project Banner">
</a>