autojobs/README.md

AutoJobs - AI-Powered Job Application Platform

Live at: https://hostpioneers.com/autojobs

What is this?

AutoJobs is a multi-user SaaS platform that automates job searching and applications using AI.

• Users add their own API keys (Jooble, JSearch, Perplexity)
• AI searches for jobs matching their profile
• AI customizes resumes and writes cover letters per job
• Application tracker with status management

Tech Stack

• Frontend: Next.js 14 (App Router), TypeScript, Tailwind CSS
• Backend: FastAPI (Python), SQLite
• Deployment: PM2, Nginx reverse proxy

Local Development

# Backend
cd backend
pip install -r requirements.txt
python start_server.py

# Frontend
cd frontend
npm install
npm run build
npm start

Deployment (on Horus VPS)

# API (port 8000)
pm2 start backend/ecosystem.config.js
pm2 save

# Frontend (port 3010)
cd frontend && nohup npx next start -p 3010 &

# Nginx config at /etc/nginx/sites-enabled/hostpioneers.com
# Routes: /autojobs -> :3010, /autojobs/api -> :8000

API Endpoints

• GET /autojobs/api/health - Health check
• POST /autojobs/api/users - Sign up
• POST /autojobs/api/users/login - Login
• GET /autojobs/api/users/me - Current user
• POST/GET /autojobs/api/users/me/api-keys - API keys
• POST/GET /autojobs/api/users/me/profile - Profile
• POST /autojobs/api/jobs/search - Search jobs
• POST /autojobs/api/ai/customize - AI customize
• GET/POST/PATCH /autojobs/api/applications - Applications
• GET /autojobs/api/admin/stats - Admin stats