hiring

Agent Kit Hiring Automation by Lamatic.ai

Agent Kit Hiring Automation is an AI-powered candidate evaluation system built with Lamatic.ai. It uses intelligent workflows to analyze resumes, match candidates to job requirements, and provide detailed hiring recommendations through a modern Next.js interface.

---

Lamatic Setup (Pre and Post)

Before running this project, you must build and deploy the flow in Lamatic, then wire its config into this codebase.

Pre: Build in Lamatic

1. Sign in or sign up at https://lamatic.ai
2. Create a project (if you don’t have one yet)
3. Click “+ New Flow” and select "Templates"
4. Select the 'Hiring' agent kit
5. Configure providers/tools/inputs as prompted
6. Deploy the kit in Lamatic and obtain your .env keys
7. Copy the keys from your studio

Post: Wire into this repo

1. Create a .env file and set the keys
2. Install and run locally:
   • npm install
   • npm run dev
3. Deploy (Vercel recommended):
   • Import your repo, set the project’s Root Directory (if applicable)
   • Add env vars in Vercel (same as your .env)
   • Deploy and test your live URL

---

🔑 Setup

Required Keys and Config

You’ll need two things to run this project locally:

1. .env Keys → get it from your Lamatic account post kit deployment.
2. Vercel Blob Token – Required for resume file storage. Each deployment needs its own Blob token. You can generate it from your Vercel project after the first deploy (see instructions below).

Item	Purpose	Where to Get It
.env Key	Authentication for Lamatic AI APIs and Orchestration	lamatic.ai
Blob Read/Write Token	Resume file storage	Vercel Blob Quickstart

1. Environment Variables

Create .env.local with:

# Lamatic
AUTOMATION_HIRING = "AUTOMATION_HIRING Flow ID"
LAMATIC_API_URL = "LAMATIC_API_URL"
LAMATIC_PROJECT_ID = "LAMATIC_PROJECT_ID"
LAMATIC_API_KEY = "LAMATIC_API_KEY"

# Vercel Blob (configured on Vercel)
BLOB_READ_WRITE_TOKEN=your_blob_token

2. Install & Run

npm install
npm run dev
# Open http://localhost:3000

3. Deploy Instructions (Vercel)

Click the “Deploy with Vercel” button.

Fill in .env Keys from lamatic (required).

After deployment, generate your own Blob token:

vercel storage blob token create

Add/Replace it in Vercel Dashboard → Environment Variables → BLOB_READ_WRITE_TOKEN and redeploy.

📂 Repo Structure

/actions
 └── orchestrate.ts        # Lamatic workflow orchestration
/app
 ├── page.tsx              # Main hiring form UI
 └── api
     └── upload-resume     # Resume upload endpoint
/lib
 ├── lamatic-client.ts     # Lamatic SDK client
 └── jobs-data.ts          # Job categories and listings
/public
 └── images
     └── lamatic-logo.png  # Lamatic branding
/flows
  └── ...                  # Lamatic Flows
/package.json              # Dependencies & scripts

---

🎯 How It Works

1. Select a Job - Browse job categories and select a position
2. Fill Application - Enter candidate details (name, email) and upload resume
3. AI Analysis - Lamatic SDK processes the application through your configured workflow
4. Get Results - View detailed evaluation with:
   • Overall match score (0-10)
   • Key strengths
   • Areas for improvement
   • Hiring recommendation (Recommended/Rejected)

---

🔧 Customization

Adding Jobs

Edit lib/jobs-data.ts to add or modify job categories and listings:

export const jobsData: JobCategory[] = [
  {
    id: "engineering",
    name: "Engineering",
    jobs: [
      {
        id: "senior-frontend",
        title: "Senior Frontend Developer",
        category: "Engineering",
        description: "Build amazing user experiences...",
        requirements: ["5+ years React", "TypeScript expert"],
        location: "Remote",
        type: "Full-time"
      }
    ]
  }
]

---

🤝 Contributing

We welcome contributions! Open an issue or PR in this repo.

---

📜 License

MIT License – see LICENSE.