🔥 Project Armageddon

Autonomous High-Velocity Remote Job Scraper, Matching Engine & Direct Outreach Engine

Project Armageddon is a production-grade automated application suite built with Python, SQLite WAL, Jinja2, and custom async scrapers. It searches global remote job platforms, filters for strict geographical and visa compliance, scores candidates against role requirements, generates customized application cover letters/pitches, and dispatches direct email applications via SMTP with PDF resume attachments.

---

🌟 Key Features

• Multi-Source Job Aggregation: Scrapes multiple remote job boards (RemoteOK, Remotive, Arbeitnow, Himalayas, WeWorkRemotely, TheMuse, Jobspresso).
• Zero-Blank-Shots Geo Matcher: GeoChecker engine validates international/worldwide remote eligibility and visa sponsorship to eliminate invalid applications.
• SQLite WAL Storage Engine: High-concurrency database tracking thousands of jobs across status lifecycles (new, scored, applied, skipped).
• Automated Cover Letter & Pitch Generator: Jinja2 templating engine crafting unique application packages tailored to every role.
• Direct Gmail SMTP Dispatcher: Automated recruiter outreach attaching custom PDF resumes with rate limiting and logging.
• Interactive War Room Dashboard: Built-in web UI served on port 8888 for monitoring progress, tracking sent emails, and filtering roles.

---

🏗️ System Architecture

┌─────────────────┐     ┌─────────────────────┐     ┌─────────────────────┐
│  Remote Job     │ ──> │   Scraper Engine    │ ──> │ SQLite WAL Database │
│  Boards         │     │ (7+ Sources)        │     │ (armageddon.db)     │
└─────────────────┘     └─────────────────────┘     └──────────┬──────────┘
                                                               │
┌─────────────────┐     ┌─────────────────────┐                │
│ Recruiter / HR  │ <── │ Direct Dispatcher   │ <──────────────┘
│ Outreach Email  │     │ (SMTP + PDF Resume) │
└─────────────────┘     └─────────────────────┘

---

⚙️ Setup & Configuration

1. Clone & Install Dependencies

git clone https://github.com/subu53/project-armageddon.git
cd project-armageddon

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r pyproject.toml

2. Configure Environment Variables

Copy .env.example to .env and fill in your details:

cp .env.example .env

Edit .env with your candidate information and Gmail SMTP credentials:

# Candidate Information
CANDIDATE_NAME="Your Name"
CANDIDATE_EMAIL="your.email@gmail.com"
RESUME_PATH="/path/to/your_resume.pdf"

# Gmail SMTP Configuration
GMAIL_USER="your.email@gmail.com"
GMAIL_APP_PASSWORD="your-16-character-app-password"

💡 Note on Gmail SMTP: Generate a 16-character App Password at Google Account App Passwords.

---

🚀 Usage & CLI Command Center

Run the CLI command center to execute scrapers, scoring, and application flows:

# Check mission status & current stats
python cli.py status

# Run multi-source scraper
python cli.py scrape

# Run job matcher & score roles
python cli.py match

# Run automated email application dispatch
python cli.py autoapply --limit 20

# Launch War Room Dashboard on http://localhost:8888
python cli.py dashboard

---

🛡️ License

MIT License — feel free to fork, adapt, and build your own autonomous application engines.