├── files
└── upwork_job_listings.txt
├── .gitignore
├── requirements.txt
├── flowchart.png
├── debug_screenshot.png
├── scrape_upwork_jobs.py
├── .dockerignore
├── chrome-extension
├── manifest.json
├── ICONS_NEEDED.md
├── background.js
├── test.html
├── styles.css
├── popup.js
├── README.md
└── popup.html
├── docker-compose.yml
├── Dockerfile
├── electron-app
├── package.json
├── index.html
├── README.md
├── styles.css
├── renderer.js
└── main.js
├── src
├── agent.py
├── utils.py
├── upwork_scraper_puppeteer.py
├── prompts.py
└── graph.py
├── QUICK_APPLY_NOW.md
├── main.py
├── scrape_with_puppeteer.py
├── BOOKMARKLET_CODE.txt
├── quick_apply.py
├── test_scraper.py
├── test_with_sample_jobs.py
├── HOW_TO_USE.md
├── SIMPLE_AUTOMATION.md
├── test_paste_script.py
├── FIX_EXTENSION.md
├── paste_job_url.py
├── deploy.sh
├── UPWORK_SCRAPING_GUIDE.md
├── automation_server.py
├── START_HERE.md
├── AUTOMATION_SETUP_GUIDE.md
├── READY_TO_APPLY.md
├── APPLY_TO_MORE_JOBS_NOW.md
├── upwork_bookmarklet.js
├── README.md
├── FULLSTACK_JOB_FINDER.md
├── PRODUCTION_READY.md
├── DEPLOYMENT.md
└── extension_server.py
/files/upwork_job_listings.txt:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | .env
2 | src/__pycache__/
3 |
--------------------------------------------------------------------------------
/requirements.txt:
--------------------------------------------------------------------------------
1 | langgraph
2 | litellm
3 | selenium
4 | webdriver_manager
5 | colorama
6 | python-dotenv
7 |
--------------------------------------------------------------------------------
/flowchart.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ai-general-kkk/Upwork-Auto-Jobs-Applier-using-AI/HEAD/flowchart.png
--------------------------------------------------------------------------------
/debug_screenshot.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/ai-general-kkk/Upwork-Auto-Jobs-Applier-using-AI/HEAD/debug_screenshot.png
--------------------------------------------------------------------------------
/scrape_upwork_jobs.py:
--------------------------------------------------------------------------------
1 | from src.utils import scrape_upwork_data, save_jobs_to_file
2 |
3 | if __name__ == "__main__":
4 | search_query = 'AI agent developer'
5 | number_of_jobs = 10
6 | job_listings = scrape_upwork_data(search_query, number_of_jobs)
7 | save_jobs_to_file(job_listings, 'files/upwork_job_listings.txt')
8 | print(job_listings)
9 |
--------------------------------------------------------------------------------
/.dockerignore:
--------------------------------------------------------------------------------
1 | # Python
2 | __pycache__/
3 | *.py[cod]
4 | *$py.class
5 | *.so
6 | .Python
7 | venv/
8 | env/
9 | ENV/
10 |
11 | # IDEs
12 | .vscode/
13 | .idea/
14 | *.swp
15 | *.swo
16 |
17 | # OS
18 | .DS_Store
19 | Thumbs.db
20 |
21 | # Git
22 | .git/
23 | .gitignore
24 |
25 | # Testing
26 | .pytest_cache/
27 | .coverage
28 | htmlcov/
29 |
30 | # Logs
31 | logs/
32 | *.log
33 |
34 | # Chrome Extension
35 | chrome-extension/
36 |
37 | # Electron App
38 | electron-app/
39 | node_modules/
40 |
41 | # Documentation
42 | *.md
43 | !README.md
44 |
45 | # Temporary files
46 | *.tmp
47 | *.bak
48 | *.old
49 |
50 | # Debug files
51 | debug_*.html
52 | debug_*.png
53 |
54 | # Test files
55 | test_*.py
56 |
57 | # Deployment scripts
58 | deploy.sh
59 |
60 | # Docker
61 | Dockerfile
62 | docker-compose.yml
63 | .dockerignore
64 |
--------------------------------------------------------------------------------
/chrome-extension/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "manifest_version": 3,
3 | "name": "Upwork Cover Letter Generator",
4 | "version": "2.0.0",
5 | "description": "Extract Upwork jobs and generate AI-powered cover letters instantly",
6 | "permissions": [
7 | "activeTab",
8 | "storage",
9 | "notifications"
10 | ],
11 | "host_permissions": [
12 | "*://www.upwork.com/*"
13 | ],
14 | "background": {
15 | "service_worker": "background.js"
16 | },
17 | "content_scripts": [
18 | {
19 | "matches": [
20 | "*://www.upwork.com/jobs/*",
21 | "*://www.upwork.com/nx/search/jobs*",
22 | "*://www.upwork.com/nx/proposals/job/*"
23 | ],
24 | "js": ["content.js"],
25 | "css": ["styles.css"]
26 | }
27 | ],
28 | "action": {
29 | "default_popup": "popup.html"
30 | }
31 | }
32 |
--------------------------------------------------------------------------------
/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.8'
2 |
3 | services:
4 | upwork-cover-letter-api:
5 | build: .
6 | container_name: upwork-cover-letter-api
7 | ports:
8 | - "5000:5000"
9 | environment:
10 | - FLASK_APP=extension_server.py
11 | - PYTHONUNBUFFERED=1
12 | # Add your API keys here or use .env file
13 | - TAVILY_API_KEY=${TAVILY_API_KEY}
14 | - GEMINI_API_KEY=${GEMINI_API_KEY}
15 | - GROQ_API_KEY=${GROQ_API_KEY}
16 | volumes:
17 | # Mount files directory to persist generated cover letters
18 | - ./files:/app/files
19 | # Mount logs directory if you add logging
20 | - ./logs:/app/logs
21 | restart: unless-stopped
22 | healthcheck:
23 | test: ["CMD", "curl", "-f", "http://localhost:5000/health"]
24 | interval: 30s
25 | timeout: 10s
26 | retries: 3
27 | start_period: 10s
28 | networks:
29 | - upwork-network
30 |
31 | networks:
32 | upwork-network:
33 | driver: bridge
34 |
--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
1 | # Upwork Cover Letter Generator - Docker Image
2 | # For deploying the Python Flask server to Hostinger or any cloud provider
3 |
4 | FROM python:3.11-slim
5 |
6 | # Set working directory
7 | WORKDIR /app
8 |
9 | # Install system dependencies
10 | RUN apt-get update && apt-get install -y \
11 | gcc \
12 | && rm -rf /var/lib/apt/lists/*
13 |
14 | # Copy requirements
15 | COPY requirements.txt .
16 |
17 | # Install Python dependencies
18 | RUN pip install --no-cache-dir -r requirements.txt && \
19 | pip install --no-cache-dir flask flask-cors gunicorn
20 |
21 | # Copy application files
22 | COPY src/ ./src/
23 | COPY files/ ./files/
24 | COPY extension_server.py .
25 | COPY .env .
26 |
27 | # Expose port
28 | EXPOSE 5000
29 |
30 | # Set environment variables
31 | ENV FLASK_APP=extension_server.py
32 | ENV PYTHONUNBUFFERED=1
33 |
34 | # Health check
35 | HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
36 | CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:5000/health')" || exit 1
37 |
38 | # Run with Gunicorn for production
39 | CMD ["gunicorn", "--bind", "0.0.0.0:5000", "--workers", "2", "--timeout", "120", "extension_server:app"]
40 |
--------------------------------------------------------------------------------
/chrome-extension/ICONS_NEEDED.md:
--------------------------------------------------------------------------------
1 | # Extension Icons Required
2 |
3 | The Chrome extension needs icon files. You have two options:
4 |
5 | ## Option 1: Quick Placeholder Icons
6 |
7 | Use any PNG icon generator online:
8 | 1. Go to https://favicon.io/favicon-generator/
9 | 2. Text: "AI"
10 | 3. Background: Rounded, Purple gradient (#667eea)
11 | 4. Download and rename files:
12 | - favicon-16x16.png → icon16.png
13 | - favicon-48x48.png → icon48.png
14 | - favicon-128x128.png → icon128.png
15 | 5. Place in chrome-extension/ folder
16 |
17 | ## Option 2: Use ImageMagick (if installed)
18 |
19 | ```bash
20 | # Create simple purple gradient icons
21 | convert -size 16x16 xc:"#667eea" icon16.png
22 | convert -size 48x48 xc:"#667eea" icon48.png
23 | convert -size 128x128 xc:"#667eea" icon128.png
24 | ```
25 |
26 | ## Option 3: Download Free Icons
27 |
28 | 1. Go to https://www.flaticon.com/search?word=robot
29 | 2. Download robot/AI icon in PNG format
30 | 3. Resize to 16x16, 48x48, 128x128
31 | 4. Place in chrome-extension/ folder
32 |
33 | **For now, the extension will work without icons - they just won't show in the toolbar.**
34 |
35 | The extension functionality will work perfectly fine without icons!
36 |
--------------------------------------------------------------------------------
/electron-app/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "upwork-cover-letter-generator",
3 | "version": "1.0.0",
4 | "description": "Desktop app for generating Upwork cover letters with AI",
5 | "main": "main.js",
6 | "scripts": {
7 | "start": "electron .",
8 | "build-mac": "electron-builder --mac",
9 | "build-win": "electron-builder --win",
10 | "build-linux": "electron-builder --linux"
11 | },
12 | "keywords": [
13 | "upwork",
14 | "ai",
15 | "cover-letter",
16 | "automation"
17 | ],
18 | "author": "Christopher Carter",
19 | "license": "MIT",
20 | "devDependencies": {
21 | "electron": "^28.0.0",
22 | "electron-builder": "^24.9.1"
23 | },
24 | "dependencies": {
25 | "puppeteer": "^21.7.0",
26 | "puppeteer-extra": "^3.3.6",
27 | "puppeteer-extra-plugin-stealth": "^2.11.2",
28 | "axios": "^1.6.0"
29 | },
30 | "build": {
31 | "appId": "com.upwork.coverletter",
32 | "productName": "Upwork Cover Letter Generator",
33 | "mac": {
34 | "category": "public.app-category.productivity",
35 | "target": [
36 | "dmg",
37 | "zip"
38 | ]
39 | },
40 | "win": {
41 | "target": [
42 | "nsis",
43 | "portable"
44 | ]
45 | },
46 | "linux": {
47 | "target": [
48 | "AppImage",
49 | "deb"
50 | ]
51 | }
52 | }
53 | }
54 |
--------------------------------------------------------------------------------
/chrome-extension/background.js:
--------------------------------------------------------------------------------
1 | /**
2 | * Background service worker
3 | * Handles extension events and notifications
4 | */
5 |
6 | // Listen for extension install
7 | chrome.runtime.onInstalled.addListener(() => {
8 | console.log('🎉 Upwork Cover Letter Generator installed!');
9 |
10 | // Show welcome notification
11 | chrome.notifications.create({
12 | type: 'basic',
13 | iconUrl: 'icon48.png',
14 | title: 'Upwork Cover Letter Generator',
15 | message: 'Extension installed! Visit any Upwork job page to see the "Generate Cover Letter" button.'
16 | });
17 | });
18 |
19 | // Listen for messages from content script
20 | chrome.runtime.onMessage.addListener((request, sender, sendResponse) => {
21 | if (request.type === 'COVER_LETTER_GENERATED') {
22 | // Show success notification
23 | chrome.notifications.create({
24 | type: 'basic',
25 | iconUrl: 'icon48.png',
26 | title: '✅ Cover Letter Ready!',
27 | message: 'Your cover letter has been generated and copied to clipboard.'
28 | });
29 | }
30 |
31 | if (request.type === 'ERROR') {
32 | // Show error notification
33 | chrome.notifications.create({
34 | type: 'basic',
35 | iconUrl: 'icon48.png',
36 | title: '⚠️ Error',
37 | message: request.message || 'An error occurred'
38 | });
39 | }
40 | });
41 |
42 | console.log('🚀 Background service worker running');
43 |
--------------------------------------------------------------------------------
/src/agent.py:
--------------------------------------------------------------------------------
1 | from colorama import Fore, init
2 | from litellm import completion
3 |
4 | # Initialize colorama for colored terminal output
5 | init(autoreset=True)
6 |
7 |
8 | class Agent:
9 | """
10 | @title AI Agent Class
11 | @notice This class defines a simple AI agent with no function calling capabilities
12 | """
13 |
14 | def __init__(self, name, model, system_prompt="", temperature=0.1):
15 | """
16 | @notice Initializes the Agent class.
17 | @param model The AI model to be used for generating responses.
18 | @param tools A list of tools that the agent can use.
19 | @param available_tools A dictionary of available tools and their corresponding functions.
20 | @param system_prompt system prompt for agent behaviour.
21 | """
22 | self.name = name
23 | self.model = model
24 | self.temperature = temperature
25 | self.system_prompt = system_prompt
26 |
27 | def invoke(self, message):
28 | print(Fore.GREEN + f"\nCalling Agent: {self.name}")
29 | messages = [
30 | {"role": "system", "content": self.system_prompt},
31 | {"role": "user", "content": message}
32 | ]
33 | response = completion(
34 | model=self.model,
35 | messages=messages,
36 | temperature=self.temperature
37 | )
38 | return response.choices[0].message.content
39 |
40 |
--------------------------------------------------------------------------------
/chrome-extension/test.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 | Extension Configuration Test
5 |
16 |
17 |
18 | 🔍 Extension Configuration Test
19 |
20 |
Current API URL:
21 | Loading...
22 |
23 |
24 |
Extension Version:
25 | Loading...
26 |
27 |
28 |
43 |
44 |
45 |
--------------------------------------------------------------------------------
/QUICK_APPLY_NOW.md:
--------------------------------------------------------------------------------
1 | # 🚀 GET YOUR COVER LETTER IN 30 SECONDS
2 |
3 | ## The Chrome extension has a caching issue. Use this GUARANTEED working method:
4 |
5 | ### Step 1: Copy the Job Description
6 |
7 | From the Upwork page, copy this entire text:
8 |
9 | ```
10 | Need A Full Stack Web Developer for my business Website re devlopment
11 |
12 | Posted 2 days ago
13 | Worldwide
14 |
15 | Summary
16 | We are looking for a talented and motivated Full-Stack Web Developer for our company website re-development. The ideal candidate will be responsible for developing and maintaining both front-end and back-end components of our web applications. You should have strong technical skills, a passion for clean and efficient code, and the ability to translate business requirements into functional, user-friendly digital solutions.
17 |
18 | Deliverables
19 | • Required Skills & Qualifications:
20 | •
21 | • Proven experience (2–5 years) as a Full-Stack Developer or similar role.
22 | • Proficiency in front-end technologies: HTML5, CSS3, JavaScript (ES6+), React.js
23 | • Strong experience in back-end technologies: Node.js, Express.js, or PHP (Laravel).
24 | • Hands-on experience with relational (MySQL/PostgreSQL) and/or NoSQL (MongoDB) databases.
25 | • Familiarity with RESTful APIs and modern development tools (Git, Docker, etc.).
26 | • Knowledge of cloud platforms (AWS, Azure, or Google Cloud) is a plus.
27 | • Good understanding of software architecture, version control, and agile methodologies.
28 | • Experience with TypeScript or Next.js / Nuxt.js.
29 | • Understanding of DevOps practices and CI/CD pipelines.
30 | • Basic knowledge of UI/UX design principles.
31 | • Familiarity with testing frameworks (Jest, Mocha, Cypress, etc.).
32 |
33 | Budget: $1,200.00 Fixed-price
34 | Experience Level: Intermediate
35 | Deadline: Nov 19, 2025
36 | ```
37 |
38 | ### Step 2: Run This Command
39 |
40 | ```bash
41 | source venv/bin/activate
42 | python paste_job_url.py
43 | ```
44 |
45 | ### Step 3: Follow Prompts
46 |
47 | 1. Choose **2** (paste description)
48 | 2. Paste the job description above
49 | 3. Press **Enter twice**
50 | 4. ✅ **Cover letter copied to clipboard!**
51 |
52 | ### Step 4: Apply on Upwork
53 |
54 | 1. Click "Apply now" button
55 | 2. Paste (Cmd+V) into cover letter field
56 | 3. Submit!
57 |
58 | ---
59 |
60 | **This method is 100% reliable and takes 30 seconds!**
61 |
62 | While you're applying, I'll fix the Chrome extension caching issue.
63 |
--------------------------------------------------------------------------------
/main.py:
--------------------------------------------------------------------------------
1 | from dotenv import load_dotenv
2 | from src.utils import read_text_file
3 | from src.graph import UpworkAutomationGraph
4 |
5 | # Load environment variables from a .env file
6 | load_dotenv()
7 |
8 | if __name__ == "__main__":
9 | # ========================================================================
10 | # JOB SEARCH STRATEGY FOR CHRISTOPHER'S PROFILE
11 | # ========================================================================
12 | #
13 | # OPTIMAL JOB TYPES (Based on Upwork profile analysis):
14 | #
15 | # TIER 1 - HIGH PRIORITY (Apply to ALL):
16 | # - "AI Agent Developer" or "AI Chatbot Developer"
17 | # - "LangChain Developer" or "GPT-4 Developer"
18 | # - "Voice AI Developer" or "Conversational AI"
19 | # - "RAG Architecture" or "Vector Database"
20 | # - "AI + UX" hybrid roles
21 | #
22 | # TIER 2 - STRONG FIT (Apply to Most):
23 | # - "VR Developer Unity" or "VR Training Simulation"
24 | # - "AR Developer" or "Mixed Reality Developer"
25 | # - "Spatial Computing" or "Hand Tracking VR"
26 | #
27 | # TIER 3 - GOOD FIT (Apply Selectively):
28 | # - "Full Stack React Python" or "Next.js FastAPI"
29 | # - "React Native Developer" or "Mobile Full Stack"
30 | # - "AWS Cloud Architect" or "GCP Developer"
31 | #
32 | # TIER 4 - LEVERAGE EXPERIENCE (Only Perfect Matches):
33 | # - "Senior UX Lead" or "Design Manager"
34 | # - "Product Design + Development"
35 | # - Strategic leadership roles with $100K+ budgets
36 | #
37 | # ========================================================================
38 | # SEARCH TIPS:
39 | # - Apply within first 5 applicants (increases interview rate by 400%)
40 | # - Target jobs posted in last 24 hours
41 | # - Look for budgets $50-100+/hr (matches your $85/hr rate)
42 | # - Prioritize clients with payment verified and good history
43 | # - Use automation for initial draft, customize first/last paragraphs
44 | # ========================================================================
45 |
46 | # Job title to search for on Upwork
47 | # Change this to match optimal job types above
48 | job_title = "AI Agent Developer"
49 |
50 | # Load the updated freelancer profile
51 | profile = read_text_file("./files/profile.md")
52 |
53 | # Run automation graph to find jobs and generate cover letters
54 | bot = UpworkAutomationGraph(profile)
55 | bot.run(job_title)
--------------------------------------------------------------------------------
/chrome-extension/styles.css:
--------------------------------------------------------------------------------
1 | /**
2 | * Content script styles
3 | * Injected into Upwork pages
4 | */
5 |
6 | /* Floating extract button */
7 | .upwork-ai-extract-btn {
8 | position: fixed;
9 | bottom: 30px;
10 | right: 30px;
11 | z-index: 99999;
12 | padding: 14px 24px;
13 | background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
14 | color: #fff;
15 | border: none;
16 | border-radius: 50px;
17 | font-size: 15px;
18 | font-weight: 600;
19 | font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
20 | cursor: pointer;
21 | box-shadow: 0 4px 20px rgba(102, 126, 234, 0.4);
22 | transition: all 0.3s ease;
23 | display: flex;
24 | align-items: center;
25 | gap: 10px;
26 | }
27 |
28 | .upwork-ai-extract-btn:hover {
29 | transform: translateY(-2px);
30 | box-shadow: 0 6px 25px rgba(102, 126, 234, 0.5);
31 | }
32 |
33 | .upwork-ai-extract-btn:active {
34 | transform: translateY(0);
35 | }
36 |
37 | .upwork-ai-extract-btn:disabled {
38 | opacity: 0.7;
39 | cursor: not-allowed;
40 | }
41 |
42 | .upwork-ai-extract-btn svg {
43 | width: 20px;
44 | height: 20px;
45 | }
46 |
47 | /* Spinner animation */
48 | .spinner {
49 | width: 16px;
50 | height: 16px;
51 | border: 2px solid rgba(255, 255, 255, 0.3);
52 | border-top-color: #fff;
53 | border-radius: 50%;
54 | animation: spin 0.8s linear infinite;
55 | }
56 |
57 | @keyframes spin {
58 | to { transform: rotate(360deg); }
59 | }
60 |
61 | /* Notification */
62 | .upwork-ai-notification {
63 | position: fixed;
64 | top: 30px;
65 | right: 30px;
66 | z-index: 100000;
67 | min-width: 300px;
68 | max-width: 500px;
69 | padding: 16px 20px;
70 | background: #fff;
71 | color: #333;
72 | border-radius: 12px;
73 | box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15);
74 | font-size: 14px;
75 | font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
76 | animation: slideIn 0.3s ease;
77 | }
78 |
79 | .upwork-ai-notification.success {
80 | border-left: 4px solid #4ade80;
81 | }
82 |
83 | .upwork-ai-notification.error {
84 | border-left: 4px solid #ef4444;
85 | }
86 |
87 | .upwork-ai-notification.warning {
88 | border-left: 4px solid #f59e0b;
89 | }
90 |
91 | .upwork-ai-notification.fade-out {
92 | animation: slideOut 0.3s ease;
93 | opacity: 0;
94 | }
95 |
96 | @keyframes slideIn {
97 | from {
98 | transform: translateX(400px);
99 | opacity: 0;
100 | }
101 | to {
102 | transform: translateX(0);
103 | opacity: 1;
104 | }
105 | }
106 |
107 | @keyframes slideOut {
108 | from {
109 | transform: translateX(0);
110 | opacity: 1;
111 | }
112 | to {
113 | transform: translateX(400px);
114 | opacity: 0;
115 | }
116 | }
117 |
--------------------------------------------------------------------------------
/scrape_with_puppeteer.py:
--------------------------------------------------------------------------------
1 | """
2 | Interactive Upwork job scraper using Puppeteer MCP
3 | This opens a real Chrome browser where you can login to Upwork
4 | """
5 | import json
6 | import time
7 |
8 |
9 | # MCP Tool wrapper functions - these will be called by Claude Code
10 | def navigate(url):
11 | """Navigate to URL using Puppeteer MCP"""
12 | # This will be replaced with actual MCP call
13 | pass
14 |
15 |
16 | def snapshot():
17 | """Take accessibility snapshot using Puppeteer MCP"""
18 | # This will be replaced with actual MCP call
19 | pass
20 |
21 |
22 | def screenshot(name="page", width=1920, height=1080):
23 | """Take screenshot using Puppeteer MCP"""
24 | # This will be replaced with actual MCP call
25 | pass
26 |
27 |
28 | def main():
29 | """
30 | Main scraping function
31 |
32 | This script will:
33 | 1. Open Upwork in a Chrome browser
34 | 2. Let you login manually
35 | 3. Navigate to job search
36 | 4. Help you collect job data
37 | """
38 |
39 | print("\n" + "="*70)
40 | print("UPWORK JOB SCRAPER (Puppeteer MCP)")
41 | print("="*70 + "\n")
42 |
43 | # Get search parameters
44 | search_query = input("Enter job search query (e.g., 'AI Developer'): ").strip()
45 | if not search_query:
46 | search_query = "AI Developer"
47 | print(f"Using default: {search_query}")
48 |
49 | num_jobs = input("How many jobs to find? (default: 10): ").strip()
50 | num_jobs = int(num_jobs) if num_jobs else 10
51 |
52 | # Construct Upwork URL
53 | url = f'https://www.upwork.com/nx/search/jobs?q={search_query}&sort=recency&page=1&per_page={num_jobs}'
54 |
55 | print(f"\n🌐 Opening Upwork: {search_query}")
56 | print(f"🎯 Looking for {num_jobs} jobs")
57 | print("\n" + "-"*70)
58 |
59 | # Instructions
60 | print("\nINSTRUCTIONS:")
61 | print("1. A Chrome browser will open with Upwork")
62 | print("2. If needed, login to your Upwork account")
63 | print("3. Once logged in, you'll see job listings")
64 | print("4. The browser will stay open for you to review jobs")
65 | print("5. You can manually copy jobs you're interested in")
66 | print("\n" + "-"*70 + "\n")
67 |
68 | input("Press ENTER to open Upwork in browser...")
69 |
70 | print("\n🚀 Launching browser...")
71 | print(f"📍 URL: {url}\n")
72 |
73 | # The actual scraping will happen here when run through Claude Code
74 | # with access to Puppeteer MCP tools
75 |
76 | print("✅ Browser should be open now!")
77 | print("\n💡 TIP: You can now:")
78 | print(" - Login to Upwork if prompted")
79 | print(" - Browse and review job listings")
80 | print(" - Copy job details you're interested in")
81 | print(" - Run the main automation with those jobs")
82 |
83 | print("\n" + "="*70)
84 | print("Browser will remain open until you close this window")
85 | print("="*70 + "\n")
86 |
87 | input("Press ENTER when done reviewing jobs...")
88 | print("\n✅ Done!")
89 |
90 |
91 | if __name__ == "__main__":
92 | main()
93 |
--------------------------------------------------------------------------------
/BOOKMARKLET_CODE.txt:
--------------------------------------------------------------------------------
1 | UPWORK AI APPLICATION BOOKMARKLET
2 | ==================================
3 |
4 | Copy the ENTIRE code below (from javascript: to the end) and save as a bookmark URL:
5 |
6 | javascript:(function(){const extractJobData=()=>{const data={title:'',description:'',budget:'',client_info:'',experience_level:'',skills:[]};const titleEl=document.querySelector('h4, h3, h2');if(titleEl)data.title=titleEl.textContent.trim();const descEl=document.querySelector('[data-test="Description"], .job-description, .description');if(descEl){data.description=descEl.textContent.trim()}else{const paras=document.querySelectorAll('p');data.description=Array.from(paras).map(p=>p.textContent).join('\n').trim()}const budgetEls=document.querySelectorAll('li, span, strong');for(let el of budgetEls){const text=el.textContent;if(text.includes('$')&&(text.includes('hr')||text.includes('Hourly')||text.includes('Fixed')||text.includes('Budget'))){data.budget=text.trim();break}}const expEls=document.querySelectorAll('strong, span');for(let el of expEls){const text=el.textContent.trim();if(text==='Expert'||text==='Intermediate'||text==='Entry Level'){data.experience_level=text;break}}return data};const generateCoverLetter=async(jobData)=>{const overlay=document.createElement('div');overlay.style.cssText='position:fixed;top:50%;left:50%;transform:translate(-50%,-50%);background:white;padding:30px;border-radius:10px;box-shadow:0 4px 20px rgba(0,0,0,0.3);z-index:999999;text-align:center;font-family:Arial,sans-serif;min-width:300px';overlay.innerHTML='🤖 Generating AI Cover Letter...
Using your Microsoft & Home Depot experience
';document.body.appendChild(overlay);try{const response=await fetch('http://localhost:5000/generate-cover-letter',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(jobData)});const result=await response.json();if(result.success){const coverLetterField=document.querySelector('textarea[name*="cover"], textarea[data-test*="cover"], textarea');if(coverLetterField){coverLetterField.value=result.cover_letter;coverLetterField.dispatchEvent(new Event('input',{bubbles:true}));coverLetterField.dispatchEvent(new Event('change',{bubbles:true}))}overlay.innerHTML=`✅ Cover Letter Generated!
Auto-filled. Review and click Send.
Rate: ${result.suggested_rate||'$85/hr'}
Length: ${result.cover_letter.length} chars
`;setTimeout(()=>overlay.remove(),5000)}else{throw new Error(result.message)}}catch(error){overlay.innerHTML=`❌ Error
${error.message}
Make sure automation_server.py is running
`}};const jobData=extractJobData();if(jobData.title){generateCoverLetter(jobData)}else{alert('Could not extract job data. Make sure you\\'re on an Upwork job page.')}})();
7 |
--------------------------------------------------------------------------------
/quick_apply.py:
--------------------------------------------------------------------------------
1 | """
2 | Quick Upwork Application - Simple copy-paste method
3 | No server, no bookmarklet, just paste job description and get cover letter
4 | """
5 | from dotenv import load_dotenv
6 | from src.utils import read_text_file
7 | from src.agent import Agent
8 | from src.prompts import generate_cover_letter_prompt
9 | import json
10 | import re
11 | import pyperclip # Will copy to clipboard automatically
12 |
13 | load_dotenv()
14 |
15 | def main():
16 | print("\n" + "=" * 70)
17 | print("🚀 QUICK UPWORK APPLICATION")
18 | print("=" * 70)
19 |
20 | # Load profile
21 | profile = read_text_file("./files/profile.md")
22 |
23 | # Initialize AI agent
24 | agent = Agent(
25 | name="Cover Letter Generator",
26 | model="gemini/gemini-2.5-flash-preview-05-20",
27 | system_prompt=generate_cover_letter_prompt.format(profile=profile),
28 | temperature=0.1
29 | )
30 |
31 | print("\n📋 Instructions:")
32 | print("1. Go to Upwork job page")
33 | print("2. Copy the ENTIRE job description")
34 | print("3. Paste it below")
35 | print("4. Press Enter twice when done")
36 | print("\n" + "-" * 70)
37 |
38 | # Get job description
39 | print("\n📝 Paste job description (press Enter twice when done):\n")
40 | lines = []
41 | while True:
42 | line = input()
43 | if line == "" and len(lines) > 0 and lines[-1] == "":
44 | break
45 | lines.append(line)
46 |
47 | job_description = "\n".join(lines).strip()
48 |
49 | if not job_description:
50 | print("\n❌ No job description provided. Exiting.")
51 | return
52 |
53 | print("\n🤖 Generating AI cover letter...")
54 | print("⏱️ This takes 2-5 seconds...\n")
55 |
56 | # Generate cover letter
57 | try:
58 | cover_letter_result = agent.invoke(job_description)
59 |
60 | # Clean up response
61 | cover_letter_result = re.sub(r'```json\s*', '', cover_letter_result)
62 | cover_letter_result = re.sub(r'```\s*$', '', cover_letter_result)
63 | cover_letter_result = cover_letter_result.strip()
64 |
65 | # Parse JSON
66 | result_json = json.loads(cover_letter_result, strict=False)
67 | cover_letter = result_json.get("letter", cover_letter_result)
68 |
69 | print("=" * 70)
70 | print("✅ COVER LETTER GENERATED")
71 | print("=" * 70)
72 | print("\n" + cover_letter + "\n")
73 | print("=" * 70)
74 | print(f"📊 Length: {len(cover_letter)} characters")
75 | print("=" * 70)
76 |
77 | # Try to copy to clipboard
78 | try:
79 | pyperclip.copy(cover_letter)
80 | print("\n✅ Copied to clipboard!")
81 | print("📋 Just paste (Cmd+V) into Upwork!")
82 | except:
83 | print("\n💡 Copy the text above and paste into Upwork")
84 |
85 | # Save to file
86 | with open('./files/latest_cover_letter.txt', 'w') as f:
87 | f.write(cover_letter)
88 |
89 | print("\n💾 Also saved to: files/latest_cover_letter.txt")
90 | print("\n🚀 Go paste it into Upwork and click Send!")
91 |
92 | except Exception as e:
93 | print(f"\n❌ Error: {str(e)}")
94 | print("Try again or check your internet connection")
95 |
96 | if __name__ == "__main__":
97 | main()
98 |
--------------------------------------------------------------------------------
/test_scraper.py:
--------------------------------------------------------------------------------
1 | """
2 | Test the Upwork scraper to diagnose why it's returning 0 jobs
3 | """
4 | import time
5 | from selenium import webdriver
6 | from selenium.webdriver.chrome.service import Service
7 | from selenium.webdriver.common.by import By
8 | from webdriver_manager.chrome import ChromeDriverManager
9 |
10 | def test_scraper():
11 | print("\n🔍 DIAGNOSING UPWORK SCRAPER")
12 | print("="*70)
13 |
14 | service = Service(ChromeDriverManager().install())
15 | driver = webdriver.Chrome(service=service)
16 |
17 | try:
18 | search_query = "AI Agent Developer"
19 | url = f'https://www.upwork.com/nx/search/jobs?q={search_query}&sort=recency&page=1&per_page=10'
20 |
21 | print(f"\n1. Testing URL: {url}")
22 | driver.get(url)
23 |
24 | print("2. Waiting 5 seconds for page load...")
25 | time.sleep(5)
26 |
27 | # Save screenshot
28 | screenshot_path = './debug_screenshot.png'
29 | driver.save_screenshot(screenshot_path)
30 | print(f"3. Screenshot saved to: {screenshot_path}")
31 |
32 | # Check page title
33 | print(f"4. Page title: {driver.title}")
34 |
35 | # Try to find jobs with old selector
36 | print("\n5. Testing OLD CSS selector: article[data-test=\"JobTile\"]")
37 | jobs_old = driver.find_elements(By.CSS_SELECTOR, 'article[data-test="JobTile"]')
38 | print(f" Found: {len(jobs_old)} jobs")
39 |
40 | # Try alternative selectors
41 | print("\n6. Testing alternative selectors:")
42 |
43 | selectors_to_try = [
44 | 'article.job-tile',
45 | 'div.job-tile',
46 | 'section.job-tile',
47 | 'article',
48 | 'div[data-ev-label="search_result"]',
49 | 'div.up-card-section',
50 | 'section[data-test="JobTile"]'
51 | ]
52 |
53 | for selector in selectors_to_try:
54 | try:
55 | elements = driver.find_elements(By.CSS_SELECTOR, selector)
56 | if len(elements) > 0:
57 | print(f" ✅ {selector}: Found {len(elements)} elements")
58 | else:
59 | print(f" ❌ {selector}: 0 elements")
60 | except Exception as e:
61 | print(f" ❌ {selector}: Error - {str(e)}")
62 |
63 | # Check page source for clues
64 | print("\n7. Checking page source for 'job' keywords...")
65 | page_source = driver.page_source.lower()
66 |
67 | if 'sign up' in page_source or 'log in' in page_source:
68 | print(" ⚠️ LOGIN REQUIRED - Upwork is blocking anonymous access!")
69 |
70 | if 'robot' in page_source or 'captcha' in page_source:
71 | print(" ⚠️ CAPTCHA/BOT DETECTION - Upwork detected automation!")
72 |
73 | if 'job-tile' in page_source:
74 | print(" ✅ Page contains 'job-tile' text")
75 | else:
76 | print(" ❌ Page doesn't contain 'job-tile' text")
77 |
78 | # Save page source
79 | with open('./debug_page_source.html', 'w', encoding='utf-8') as f:
80 | f.write(driver.page_source)
81 | print("\n8. Full page source saved to: debug_page_source.html")
82 |
83 | finally:
84 | driver.quit()
85 |
86 | print("\n" + "="*70)
87 | print("📊 DIAGNOSIS COMPLETE")
88 | print("="*70)
89 |
90 | if __name__ == "__main__":
91 | test_scraper()
92 |
--------------------------------------------------------------------------------
/src/utils.py:
--------------------------------------------------------------------------------
1 | import time
2 | from selenium import webdriver
3 | from selenium.webdriver.chrome.service import Service
4 | from selenium.webdriver.common.by import By
5 | from webdriver_manager.chrome import ChromeDriverManager
6 |
7 | def read_text_file(filename):
8 | with open(filename, 'r', encoding='utf-8') as file:
9 | lines = file.readlines()
10 | # Strip newline characters and any surrounding whitespace
11 | lines = [line.strip() for line in lines if line.strip()]
12 | return "".join(lines)
13 |
14 | def scrape_upwork_data(search_query, num_jobs):
15 | # Setup Chrome WebDriver
16 | service = Service(ChromeDriverManager().install())
17 | driver = webdriver.Chrome(service=service)
18 |
19 | job_listings = []
20 |
21 | try:
22 | # Open Upwork job search page
23 | url = f'https://www.upwork.com/nx/search/jobs?q={search_query}&sort=recency&page=1&per_page={num_jobs}'
24 | driver.get(url)
25 |
26 | # Wait for the page to load
27 | time.sleep(5)
28 |
29 | # Find job listings
30 | jobs = driver.find_elements(By.CSS_SELECTOR, 'article[data-test="JobTile"]')
31 |
32 | # Extract and collect job details
33 | for job in jobs:
34 | try:
35 | title_element = job.find_element(By.CSS_SELECTOR, 'h2.job-tile-title > a')
36 | title = title_element.text.strip()
37 | link = title_element.get_attribute('href')
38 | description = job.find_element(By.CSS_SELECTOR, 'div[data-test="JobTileDetails"] > div > div > p').text.strip()
39 |
40 | job_info = job.find_element(By.CSS_SELECTOR, 'ul.job-tile-info-list')
41 | job_type = job_info.find_element(By.CSS_SELECTOR, 'li[data-test="job-type-label"]').text.strip()
42 | experience_level = job_info.find_element(By.CSS_SELECTOR, 'li[data-test="experience-level"]').text.strip()
43 |
44 | # Check for budget (fixed price or hourly)
45 | try:
46 | budget = job_info.find_element(By.CSS_SELECTOR, 'li[data-test="is-fixed-price"]').text.strip()
47 | except:
48 | budget = job_info.find_element(By.CSS_SELECTOR, 'li[data-test="duration-label"]').text.strip()
49 |
50 | job_listings.append({
51 | 'title': title,
52 | 'link': link,
53 | 'description': description,
54 | 'job_type': job_type,
55 | 'experience_level': experience_level,
56 | 'budget': budget
57 | })
58 | except Exception as e:
59 | print(f'Error parsing job listing: {e}')
60 | continue
61 |
62 | finally:
63 | # Close the browser
64 | driver.quit()
65 |
66 | return job_listings
67 |
68 | def save_jobs_to_file(job_listings, filename):
69 | with open(filename, 'w', encoding='utf-8') as file:
70 | for job in job_listings:
71 | file.write(f"Title: {job['title']}\n")
72 | file.write(f"Link: {job['link']}\n")
73 | file.write(f"Description: {job['description']}\n")
74 | file.write(f"Job Type: {job['job_type']}\n")
75 | file.write(f"Experience Level: {job['experience_level']}\n")
76 | file.write(f"Budget: {job['budget']}\n")
77 | file.write("\n---\n\n")
--------------------------------------------------------------------------------
/test_with_sample_jobs.py:
--------------------------------------------------------------------------------
1 | """
2 | Test script with sample Upwork jobs to demonstrate cover letter generation
3 | """
4 | from dotenv import load_dotenv
5 | from src.utils import read_text_file, save_jobs_to_file
6 | from src.graph import UpworkAutomationGraph
7 |
8 | # Load environment variables
9 | load_dotenv()
10 |
11 | # Sample Upwork job listings for testing
12 | sample_jobs = [
13 | {
14 | 'title': 'AI Agent Developer for Customer Support Automation',
15 | 'link': 'https://www.upwork.com/jobs/sample1',
16 | 'description': 'We are looking for an experienced AI developer to build an autonomous customer support agent using LangChain and GPT-4. The agent should handle 80% of customer inquiries automatically. Experience with vector databases and RAG architecture required. Must have portfolio of similar AI agent projects.',
17 | 'job_type': 'Hourly',
18 | 'experience_level': 'Expert',
19 | 'budget': '$50-$100/hr'
20 | },
21 | {
22 | 'title': 'Full Stack Developer - React & Python',
23 | 'link': 'https://www.upwork.com/jobs/sample2',
24 | 'description': 'Need a full-stack developer to build a SaaS platform from scratch. Tech stack: React, Next.js, Python FastAPI, PostgreSQL, AWS. The application will have user authentication, payment integration (Stripe), and real-time data synchronization. Looking for someone who can work independently and deliver high-quality code.',
25 | 'job_type': 'Fixed Price',
26 | 'experience_level': 'Expert',
27 | 'budget': 'Fixed price - $8000'
28 | },
29 | {
30 | 'title': 'VR Experience Developer for Training Simulation',
31 | 'link': 'https://www.upwork.com/jobs/sample3',
32 | 'description': 'We need a VR developer to create an immersive training simulation for healthcare workers. Unity 3D experience required. Should include hand tracking, haptic feedback, and realistic medical scenarios. Previous work in VR training or medical simulations is a plus.',
33 | 'job_type': 'Fixed Price',
34 | 'experience_level': 'Intermediate',
35 | 'budget': 'Fixed price - $12000'
36 | }
37 | ]
38 |
39 | if __name__ == "__main__":
40 | print("🧪 Testing with sample Upwork jobs...\n")
41 |
42 | # Save sample jobs to file
43 | save_jobs_to_file(sample_jobs, './files/upwork_job_listings.txt')
44 |
45 | # Load profile
46 | profile = read_text_file("./files/profile.md")
47 |
48 | # Create bot
49 | bot = UpworkAutomationGraph(profile, num_jobs=3)
50 |
51 | # Manually run the workflow with sample data
52 | job_listings_str = "\n".join(map(str, sample_jobs))
53 |
54 | state = {
55 | "job_title": "AI Developer (Test)",
56 | "scraped_jobs_list": job_listings_str,
57 | "matches": [],
58 | "job_description": "",
59 | "cover_letter": "",
60 | "num_matches": 0
61 | }
62 |
63 | print("✅ Sample jobs loaded")
64 | print("\n📊 Classifying jobs with AI...")
65 | state = bot.classify_scraped_jobs(state)
66 |
67 | print("\n🔍 Checking for matches...")
68 | state = bot.check_for_job_matches(state)
69 |
70 | if len(state['matches']) > 0:
71 | print(f"\n✅ Found {len(state['matches'])} matching jobs!")
72 | print("\n✍️ Generating cover letters...\n")
73 |
74 | # Generate cover letters for all matches
75 | while len(state['matches']) > 0:
76 | state = bot.generate_cover_letter(state)
77 | state = bot.save_cover_letter(state)
78 |
79 | print("\n✅ Done! Cover letters saved to: files/cover_letter.txt")
80 | print("\nYou can now review the generated cover letters.")
81 | else:
82 | print("\n⚠️ No matching jobs found")
83 |
--------------------------------------------------------------------------------
/chrome-extension/popup.js:
--------------------------------------------------------------------------------
1 | /**
2 | * Popup script - Displays status and latest job info
3 | */
4 |
5 | // Check server status
6 | async function checkServerStatus() {
7 | const indicator = document.getElementById('server-indicator');
8 | const statusText = document.getElementById('server-status');
9 |
10 | try {
11 | const response = await fetch('http://46.202.93.22:5000/health', {
12 | method: 'GET',
13 | signal: AbortSignal.timeout(2000)
14 | });
15 |
16 | if (response.ok) {
17 | indicator.classList.add('active');
18 | indicator.classList.remove('inactive');
19 | statusText.textContent = 'Running';
20 | } else {
21 | throw new Error('Server not responding');
22 | }
23 | } catch (error) {
24 | indicator.classList.add('inactive');
25 | indicator.classList.remove('active');
26 | statusText.textContent = 'Offline';
27 | }
28 | }
29 |
30 | // Load latest job data
31 | function loadLatestJob() {
32 | chrome.storage.local.get(['latestJob', 'latestCoverLetter', 'timestamp'], (result) => {
33 | const container = document.getElementById('latest-job-container');
34 |
35 | if (result.latestJob && result.latestCoverLetter) {
36 | const job = result.latestJob;
37 | const timestamp = new Date(result.timestamp);
38 | const timeAgo = getTimeAgo(timestamp);
39 |
40 | container.innerHTML = `
41 |
42 |
Latest Generated Letter
43 |
${job.title || 'Untitled Job'}
44 |
${timeAgo}
45 |
48 |
51 |
73 |
No cover letters generated yet.
74 |
Visit an Upwork job page to get started!
75 |
11 |
12 |
16 |
17 |
18 |
19 |
20 | Python Server:
21 |
22 |
23 | Checking...
24 |
25 |
26 |
27 | Browser:
28 |
29 |
30 | Not launched
31 |
32 |
33 |
34 | Jobs Processed:
35 | 0
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
🚀 Launch Browser
45 |
Opens Chrome with stealth mode to browse Upwork
46 |
47 |
48 |
49 |
50 |
51 |
52 |
55 |
58 |
59 |
60 |
61 |
📝 Generate Cover Letter
62 |
Extract job and generate AI cover letter
63 |
64 |
67 |
68 |
69 |
📖 How to use:
70 |
71 | - Click "Launch Browser"
72 | - Login to Upwork in the browser that opens
73 | - Navigate to any job page
74 | - Click "Extract & Generate"
75 | - Wait for AI to generate cover letter
76 | - Copy and paste into Upwork!
77 |
78 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
📋 Latest Cover Letter
86 |
87 |
88 |
89 |
Generating cover letter...
90 |
91 |
92 |
96 |
97 |
98 |
99 |
102 |
103 |
104 |
105 |
📊 Activity Log
106 |
107 |
108 |
109 |
110 |
167 |
168 | Python Server:
169 |
170 |
171 | Checking...
172 |
173 |
174 |
175 | Jobs Processed:
176 | 0
177 |
178 |
🤖 Generating AI Cover Letter...
151 | Using your Microsoft & Home Depot experience
152 | `;
153 | document.body.appendChild(overlay);
154 |
155 | try {
156 | // Extract job data
157 | const jobData = extractJobData();
158 | console.log('Job data extracted:', jobData);
159 |
160 | // Generate cover letter
161 | const result = await generateCoverLetter(jobData);
162 |
163 | // Auto-fill the form
164 | fillCoverLetter(result.cover_letter, result.suggested_rate);
165 |
166 | // Update overlay
167 | overlay.innerHTML = `
168 | ✅ Cover Letter Generated!
169 | Filled into form. Review and click Send.
170 |
171 | Rate: ${result.suggested_rate || '$85/hr'}
172 | Length: ${result.cover_letter.length} chars
173 |
174 |
184 | `;
185 |
186 | // Auto-close after 5 seconds
187 | setTimeout(() => overlay.remove(), 5000);
188 |
189 | } catch (error) {
190 | overlay.innerHTML = `
191 | ❌ Error
192 | ${error.message}
193 |
194 | Make sure automation_server.py is running
195 |
196 |
205 | `;
206 | }
207 | }
208 |
209 | main();
210 | })();
211 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 |
7 |
8 | # UpworkScribe AI: Automated Jobs Application on Upwork
9 |
10 | **UpworkScribe AI is not just a tool; it's your partner in navigating the competitive world of freelancing, helping you secure more projects and grow your freelance career. 🚀**
11 |
12 | ## Introduction
13 |
14 | **UpworkScribe AI** is an AI tool designed to simplify and accelerate the freelance job application process on Upwork. In today's fast-paced gig economy, where opportunities can disappear within hours, this system offers freelancers a significant edge. By harnessing the power of AI and automation, it enables freelancers to efficiently apply to multiple relevant projects with personalized cover letters, maximizing their chances of securing ideal freelance opportunities.
15 |
16 | ## The Challenge of Modern Freelancing
17 |
18 | The freelance marketplace has undergone a dramatic transformation in the digital age. While platforms like Upwork have opened up a world of opportunities, they have also intensified competition. Freelancers often find themselves spending countless hours searching for suitable projects, tailoring proposals, and crafting unique cover letters. This process can be not only time-consuming but also mentally exhausting, leading to missed opportunities and proposal fatigue.
19 |
20 | ## Enter UpworkScribe AI: Your Personal Freelance Assistant
21 |
22 | UpworkScribe AI steps in as a game-changing solution to these challenges. It's not just a tool; it's your tireless, 24/7 freelance proposal partner. By automating the most time-consuming aspects of the job search and application process, it allows you to focus on what truly matters - preparing for client interviews and delivering outstanding work.
23 |
24 | ## Features
25 |
26 | ### Jobs Scraping and Classification
27 |
28 | - Customizable search criteria based on user-provided job titles
29 | - Continuous scanning for new project listings
30 | - Smart classification to identify jobs matching the freelancer profiles
31 |
32 | ### AI Cover Letter Generation
33 |
34 | - Dynamic cover letter creation based on job descriptions
35 | - Personalization aligned with user writing style, skills and past experiences.
36 | - Keyword optimization for improved proposal relevance
37 |
38 | ## How It Works
39 |
40 | 1. **Job Scraping**: The system scrapes Upwork for job listings based on user-provided criteria.
41 | 2. **Job Classification**: AI agents classify scraped jobs to identify the best matches for the user's freelance profile.
42 | 3. **Cover Letter Generation**: Personalized cover letters are created using AI, tailored to each job description and the user's skills, experience and writing style.
43 | 4. **Review and Submission**: Generated cover letters are saved for user review before submission.
44 |
45 | ### System Flowchart
46 |
47 | This is the detailed flow of the system:
48 |
49 | [](https://mermaid.live/edit#pako:eNqdk0FvozAQhf-K5UirrZRI0eaScKiUQBulaquqNOoBejB4CFbARrZJWiX57x0H0tJbFw54Bt735hnhA00VB-rRjWZVTl6CWBK85tHagCYrWdX2jYxG18c7lZAXYQs4ksVf14QpEqCvGmBxFj2zPXHv7oWxQm7MkfgH1_sFM0ZkAi1b_w1Ie2pq_4w-MJvmwB2OWBD5aofqe7AWl1ctcOmgb110Lcsf8E0UCJMyzVtVc79ttvSkVSYKaDblfDEnCe2H21jQ1QdnxRIkaGbRuxsIhyyjZ9gJ2JM_JGQ7aEctz9C8qjSq-ZGsorBOSmGJVWRd7ZXe_hA-AnBDnJERSjYBYtkojMtE5gTTFt4gm2VDY7XagjeYTqdtPdoLbnPvX_U-TFWhtDcYj8ddfNHiSfKNTyaT3-L-ZXqS9MGDy_SsF37T4pzzPvjtJXw264Mvv758L3zV4rP_mU6HtARdMsHxRB6cXUxtDiXE1MOSM72NaSxPqGO1VeGHTKlndQ1DqlW9yamXscJgV1ccf9pAMDzWZfv09AkL_EYn)
50 |
51 | ## Tech Stack
52 |
53 | ### **Using Langgraph**
54 |
55 | - For building agentic workflows, there are multiple popular frameworks available, such as CrewAI, AutoGen, or Agency Swarm. However, most of them grant full autonomy to the agents while accomplishing tasks and do not provide control over the working process of the agents.
56 |
57 | - With Langgraph, you gain that control. You can decide when each agent or tool needs to be called, and you can add custom feedback based on the agent's output, which aids in self-improvement. Essentially, Langgraph is the best choice when you know exactly the process flow of your application, whereas other frameworks allow agents to choose the process.
58 |
59 | - Langgraph also enables you to use an LLM only when necessary. For example, in this application, we need to scrape jobs from Upwork, which does not require an LLM call; a simple node tool suffices. In other frameworks, you would need to create an agent that calls the scraping tool through function calling, which helps reduce the application's cost.
60 |
61 | ### **Using LiteLLM**
62 |
63 | - LiteLLM is a framework that standardizes calls to 100+ LLMs. It allows interaction with different LLMs beyond OpenAI (GPT models) using the same input/output format, simplifying the process of switching models for the application to just changing the model name.
64 |
65 | * **Use LLAMA3 with GROQ**:
66 |
67 | ```python
68 | from litellm import completion
69 |
70 | response = completion(
71 | model="groq/llama3-70b-8192",
72 | messages=messages,
73 | temperature=0.1
74 | )
75 | ```
76 |
77 | * **Use Google Gemini**:
78 |
79 | ```python
80 | response = completion(
81 | model="gemini/gemini-1.5-flash",
82 | messages=messages,
83 | temperature=0.1
84 | )
85 | ```
86 |
87 | ### **Future Improvements**
88 |
89 | While the current app provides correct results, it requires further tuning to be used in real job applications.
90 |
91 | - Currently, only two example letters are provided to the writer agent (directly in its prompt) for crafting personalized letters. This is insufficient, and it would be better to create a file containing multiple cover letters written in the user's style, which will improve the model's output.
92 |
93 | - **Enhanced Feedback Loop**: Implement a mechanism for continuous feedback from user, allowing the model to adapt and learn from user writing style (similar to reinforcement learning from human feedback).
94 |
95 | ## How to Run
96 |
97 | ### Prerequisites
98 |
99 | - Python 3.9+
100 | - Tavily API key
101 | - Groq API key (for Llama3)
102 | - Google Gemini API key (for using Gemini model)
103 | - Necessary Python libraries (listed in `requirements.txt`)
104 |
105 | ### Setup
106 |
107 | 1. **Clone the repository:**
108 |
109 | ```sh
110 | git clone https://github.com/AIXerum/Upwork-Auto-Jobs-Applier-using-AI.git
111 | cd Upwork-Auto-Jobs-Applier-using-AI
112 | ```
113 |
114 | 2. **Create and activate a virtual environment:**
115 |
116 | ```sh
117 | python -m venv venv
118 | source venv/bin/activate # On Windows use `venv\Scripts\activate`
119 | ```
120 |
121 | 3. **Install the required packages:**
122 |
123 | ```sh
124 | pip install -r requirements.txt
125 | ```
126 |
127 | 4. **Set up environment variables:**
128 |
129 | Create a `.env` file in the root directory of the project and add your API keys:
130 |
131 | ```env
132 | TAVILY_API_KEY=your_tavily_api_key
133 | GEMINI_API_KEY=your_gemini_api_key
134 | GROQ_API_KEY=your_groq_api_key
135 | ```
136 |
137 | ### Running the Application
138 |
139 | 1. **Start the workflow:**
140 |
141 | ```sh
142 | python main.py
143 | ```
144 |
145 | The application will start scraping job listings, classifying them, generating cover letters, and saving the results.
146 |
147 | By default at the end of the process, all the cover letters generated are saved under `files/cover_letter.txt` file.
148 |
149 | 3. You can test the Upwork jobs scraping tool by running:
150 | ```sh
151 | python scrape_upwork_jobs.py
152 | ```
153 |
154 | ### Customization
155 |
156 | * To use this automation for you own profile, just add your profile into `files/profile.md` and remove the example profile.
157 |
158 | * You can customize the behavior of each agent by modifying the corresponding agent prompt in the `prompts` script.
159 |
--------------------------------------------------------------------------------
/FULLSTACK_JOB_FINDER.md:
--------------------------------------------------------------------------------
1 | # 🚀 Full-Stack Job Finder - Step-by-Step Guide
2 |
3 | ## Right Now: Find 5 Jobs in 15 Minutes
4 |
5 | ### Step 1: Open Upwork (5 minutes)
6 |
7 | Go to Upwork and use these exact searches:
8 |
9 | **Search #1: Full Stack React Python**
10 | 1. Go to: https://www.upwork.com/nx/search/jobs
11 | 2. Search: `full stack react python`
12 | 3. Click "Most Recent" to sort
13 | 4. Look at jobs posted in last 24 hours
14 |
15 | **Search #2: Next.js Python**
16 | 1. Search: `nextjs python`
17 | 2. Sort by "Most Recent"
18 |
19 | **Search #3: React FastAPI**
20 | 1. Search: `react fastapi`
21 | 2. Sort by "Most Recent"
22 |
23 | ---
24 |
25 | ### Step 2: Quick Filter (5 minutes)
26 |
27 | For each job listing, check:
28 | - ✅ Budget: $50+/hr OR $5,000+ fixed
29 | - ✅ Posted: Last 24 hours
30 | - ✅ Proposals: Less than 15
31 | - ✅ Client: Payment verified
32 | - ✅ Description: Detailed and specific
33 |
34 | **Open 5-10 promising jobs in new tabs**
35 |
36 | ---
37 |
38 | ### Step 3: Collect Job Data (5 minutes)
39 |
40 | For each job, copy and paste here in this format:
41 |
42 | ```
43 | JOB #1:
44 | Title: [paste title]
45 | Link: [paste URL]
46 | Budget: [paste budget]
47 | Experience: [Expert/Intermediate/Entry]
48 | Job Type: [Hourly/Fixed Price]
49 |
50 | Description:
51 | [paste full description]
52 |
53 | ---
54 | ```
55 |
56 | Then send them to me!
57 |
58 | ---
59 |
60 | ## 💡 What Makes a GOOD Full-Stack Job for You
61 |
62 | ### Perfect Match Jobs:
63 |
64 | **Example 1:**
65 | ```
66 | Title: "Full Stack Developer - React, Next.js, Python, AWS"
67 | Budget: $60-90/hr or $8,000+ fixed
68 | Client: Payment verified, 5+ hires, US-based
69 | Description: "Building SaaS platform, need authentication, payments,
70 | real-time features, PostgreSQL..."
71 |
72 | WHY PERFECT:
73 | ✓ Tech stack matches exactly
74 | ✓ Complex requirements (not basic CRUD)
75 | ✓ Enterprise features (auth, payments)
76 | ✓ Scalability needed (your strength)
77 | ```
78 |
79 | **Example 2:**
80 | ```
81 | Title: "Senior Full Stack Engineer - TypeScript, Python, Cloud"
82 | Budget: $70-100/hr
83 | Client: Fortune 500, ongoing work
84 | Description: "Modernize internal platform, React frontend, FastAPI
85 | backend, AWS deployment, must have enterprise experience..."
86 |
87 | WHY PERFECT:
88 | ✓ Enterprise client (your background)
89 | ✓ Modern stack (TypeScript, FastAPI)
90 | ✓ Cloud deployment (your AWS certs)
91 | ✓ Leadership implied (your management experience)
92 | ```
93 |
94 | **Example 3:**
95 | ```
96 | Title: "Build Real-Time Collaboration Tool - React + Node.js"
97 | Budget: $12,000 fixed
98 | Client: Startup, 10+ hires, payment verified
99 | Description: "Need full-stack dev for MVP. WebSockets, React, Node.js,
100 | PostgreSQL. 6-week timeline. Looking for someone who can own it..."
101 |
102 | WHY PERFECT:
103 | ✓ Real-time features (Connectful experience)
104 | ✓ Full ownership (you work independently)
105 | ✓ Startup (you've launched products)
106 | ✓ Clear timeline (6 weeks is realistic)
107 | ```
108 |
109 | ---
110 |
111 | ## 🎯 Sample Jobs I Found for You (Examples)
112 |
113 | Based on typical Upwork full-stack jobs, here are examples of what to look for:
114 |
115 | ### Sample Job #1: SaaS Platform
116 | ```python
117 | {
118 | 'title': 'Full Stack Developer - Build SaaS Analytics Platform',
119 | 'link': 'https://www.upwork.com/jobs/~[job-id]',
120 | 'description': '''
121 | We are building a SaaS analytics platform for e-commerce businesses.
122 |
123 | Tech Stack Required:
124 | - Frontend: React, Next.js, TypeScript, TailwindCSS
125 | - Backend: Python, FastAPI, PostgreSQL
126 | - Cloud: AWS (Lambda, RDS, S3)
127 | - Features: User auth, dashboard, data visualization, API integrations
128 |
129 | Requirements:
130 | - 5+ years full-stack experience
131 | - Experience with payment integration (Stripe)
132 | - Ability to work independently
133 | - Clean code, testing, documentation
134 | - Available to start within 1 week
135 |
136 | Budget: $8,000-12,000 for MVP (4-6 weeks)
137 |
138 | Please include:
139 | 1. Link to similar SaaS project you've built
140 | 2. Your approach to architecting scalable backend
141 | 3. Availability and estimated timeline
142 | ''',
143 | 'job_type': 'Fixed Price',
144 | 'experience_level': 'Expert',
145 | 'budget': 'Fixed price - $8,000-12,000'
146 | }
147 | ```
148 |
149 | ---
150 |
151 | ### Sample Job #2: Real-Time Collaboration
152 | ```python
153 | {
154 | 'title': 'Senior Full Stack Developer - Real-Time Collaboration Tool',
155 | 'link': 'https://www.upwork.com/jobs/~[job-id]',
156 | 'description': '''
157 | Building a real-time collaboration platform (think Figma/Miro style).
158 |
159 | Tech Requirements:
160 | - React + TypeScript for frontend
161 | - Node.js + Express for backend
162 | - WebSockets for real-time sync
163 | - PostgreSQL + Redis
164 | - AWS deployment
165 |
166 | What we need:
167 | - Someone who can architect the real-time sync system
168 | - Experience with multiplayer/collaborative features
169 | - WebSocket expertise
170 | - Can start this week
171 |
172 | Budget: $75/hr, estimated 160 hours (4 weeks @ 40hr/week)
173 |
174 | Questions:
175 | 1. Have you built real-time collaborative features before?
176 | 2. How would you approach conflict resolution in real-time edits?
177 | 3. What's your availability?
178 | ''',
179 | 'job_type': 'Hourly',
180 | 'experience_level': 'Expert',
181 | 'budget': '$75/hr'
182 | }
183 | ```
184 |
185 | ---
186 |
187 | ### Sample Job #3: Enterprise Platform Modernization
188 | ```python
189 | {
190 | 'title': 'Modernize Enterprise Application - React + Python',
191 | 'link': 'https://www.upwork.com/jobs/~[job-id]',
192 | 'description': '''
193 | Fortune 500 company needs to modernize legacy internal platform.
194 |
195 | Current: Old PHP monolith
196 | Target: Modern React frontend + Python microservices
197 |
198 | Tech Stack:
199 | - Frontend: React, TypeScript, Material-UI
200 | - Backend: Python, FastAPI, PostgreSQL
201 | - Cloud: AWS (ECS, RDS, CloudFront)
202 | - Requirements: OAuth SSO, role-based access, API design
203 |
204 | Looking for:
205 | - 7+ years enterprise development experience
206 | - Experience migrating legacy systems
207 | - Strong architecture skills
208 | - Excellent communication (will work with internal teams)
209 |
210 | Rate: $80-100/hr
211 | Duration: 3-6 months, 30 hrs/week
212 |
213 | Please answer:
214 | - Have you migrated legacy systems before?
215 | - What's your approach to ensuring zero downtime during migration?
216 | ''',
217 | 'job_type': 'Hourly',
218 | 'experience_level': 'Expert',
219 | 'budget': '$80-100/hr'
220 | }
221 | ```
222 |
223 | ---
224 |
225 | ## 🎁 Bonus: How to Use These Samples
226 |
227 | **Option 1: Test Your Automation**
228 | 1. Copy these 3 sample jobs into `test_with_sample_jobs.py`
229 | 2. Run the automation
230 | 3. See what cover letters it generates
231 | 4. Use them as templates for real applications
232 |
233 | **Option 2: Find Real Jobs Matching These Patterns**
234 | When browsing Upwork, look for jobs with similar:
235 | - Tech stacks (React + Python/Node.js)
236 | - Budget ranges ($75-100/hr, $8-12K fixed)
237 | - Client quality (payment verified, enterprise)
238 | - Requirements (authentication, payments, real-time, cloud)
239 |
240 | ---
241 |
242 | ## 📞 What To Do Right Now
243 |
244 | **I've created this guide for you, now YOU need to:**
245 |
246 | 1. **Open Upwork in your browser**
247 | 2. **Search for "full stack react python"**
248 | 3. **Find 3-5 jobs** posted in last 24 hours
249 | 4. **Copy the job details** exactly as shown in the template
250 | 5. **Paste them here** or directly into `test_with_sample_jobs.py`
251 |
252 | **Then I'll:**
253 | 1. Generate customized cover letters for each job
254 | 2. Help you refine them for maximum impact
255 | 3. Guide you through applying
256 |
257 | **The bottleneck is Upwork's Cloudflare protection - I can't scrape automatically, but once you give me the job details, I can generate amazing proposals in seconds!**
258 |
259 | Ready? Go find those jobs and paste them here! 🚀
260 |
261 | ---
262 |
263 | ## 💰 Target Jobs for Today
264 |
265 | Look for these specific combinations:
266 |
267 | **High Value ($10K+ or $80+/hr):**
268 | - "Full Stack SaaS Platform" + React + Python + AWS
269 | - "Enterprise Application" + TypeScript + FastAPI + PostgreSQL
270 | - "Real-Time Platform" + WebSockets + Next.js + Node.js
271 |
272 | **Good Value ($5-10K or $60-80/hr):**
273 | - "Full Stack Developer" + React + Python/Node.js
274 | - "Web Application" + Next.js + FastAPI
275 | - "Marketplace Platform" + React + MongoDB
276 |
277 | **Quick Wins (Get Algorithm Moving):**
278 | - "Full Stack MVP" + $3-5K + Clear scope
279 | - "React + Python Developer" + Hourly rate + 2-4 week project
280 |
281 | Apply to 2-3 high value + 3-5 good value = 5-8 applications today!
282 |
--------------------------------------------------------------------------------
/PRODUCTION_READY.md:
--------------------------------------------------------------------------------
1 | # 🎉 YOUR API IS NOW LIVE IN PRODUCTION!
2 |
3 | ## ✅ Deployment Status
4 |
5 | **API URL**: `http://46.202.93.22:5000`
6 | **Status**: ✅ ONLINE and responding
7 | **Health Check**: `http://46.202.93.22:5000/health`
8 | **Hosted On**: Hostinger VPS (Docker Container)
9 |
10 | ---
11 |
12 | ## 🚀 What's Working Right Now
13 |
14 | ### 1. ✅ Production API Server
15 | - Running on Hostinger VPS at `46.202.93.22:5000`
16 | - Docker container with auto-restart
17 | - Health check endpoint active
18 | - Flask + Gunicorn production setup
19 | - API keys configured
20 |
21 | ### 2. ✅ Chrome Extension (Updated)
22 | - Connected to production API
23 | - No need for local Python server
24 | - Works from anywhere with internet
25 | - Files updated:
26 | - `chrome-extension/content.js` → Production URL
27 | - `chrome-extension/popup.js` → Production URL
28 |
29 | ### 3. ✅ Paste Script (Still Works Locally)
30 | - `paste_job_url.py` → Local AI generation
31 | - No server needed
32 | - 100% reliable fallback
33 |
34 | ---
35 |
36 | ## 📖 How to Use Production Setup
37 |
38 | ### **OPTION 1: Chrome Extension** (Recommended)
39 |
40 | #### Installation:
41 | 1. Open Chrome: `chrome://extensions/`
42 | 2. Enable "Developer mode" (top right toggle)
43 | 3. Click "Load unpacked"
44 | 4. Select folder: `chrome-extension/`
45 | 5. Extension installed! 🎉
46 |
47 | #### Usage:
48 | 1. **Go to Upwork** (login normally)
49 | 2. **Open any job page**
50 | 3. **Look for floating purple button** (bottom-right corner)
51 | 4. **Click "Generate Cover Letter"**
52 | 5. **Wait 2-5 seconds**
53 | 6. ✅ **Cover letter copied to clipboard!**
54 | 7. **Paste into Upwork** and apply!
55 |
56 | **No Python server needed** - it connects to your Hostinger VPS automatically!
57 |
58 | ---
59 |
60 | ### **OPTION 2: Paste Script** (Backup Method)
61 |
62 | If Chrome extension has issues, use the paste script:
63 |
64 | ```bash
65 | source venv/bin/activate
66 | python paste_job_url.py
67 |
68 | # Choose option 2
69 | # Paste job description
70 | # Press Enter twice
71 | # ✅ Cover letter copied!
72 | ```
73 |
74 | ---
75 |
76 | ## 🔧 Managing Your Production Server
77 |
78 | ### View Logs
79 | ```bash
80 | ssh root@46.202.93.22 'docker logs upwork-api -f'
81 | ```
82 |
83 | ### Restart Server
84 | ```bash
85 | ssh root@46.202.93.22 'docker restart upwork-api'
86 | ```
87 |
88 | ### Stop Server
89 | ```bash
90 | ssh root@46.202.93.22 'docker stop upwork-api'
91 | ```
92 |
93 | ### Check Status
94 | ```bash
95 | curl http://46.202.93.22:5000/health
96 | ```
97 |
98 | ### Update Code (Redeploy)
99 | ```bash
100 | ./deploy.sh
101 | ```
102 |
103 | ---
104 |
105 | ## 📊 Testing Your Setup
106 |
107 | ### 1. Test API Health
108 | ```bash
109 | curl http://46.202.93.22:5000/health
110 | ```
111 |
112 | **Expected Response:**
113 | ```json
114 | {
115 | "status": "ok",
116 | "message": "Server is running",
117 | "jobs_processed": 0
118 | }
119 | ```
120 |
121 | ### 2. Test Chrome Extension
122 |
123 | 1. Visit: https://www.upwork.com/jobs/Full-Stack-Developer-for-Electron-Packaging-for-windows-application_~021979601231295668473/
124 | 2. Look for purple button at bottom-right
125 | 3. Click "Generate Cover Letter"
126 | 4. Should see notification: "✅ Cover letter generated and copied!"
127 | 5. Paste in a text editor to verify
128 |
129 | ### 3. Check Extension Popup
130 |
131 | 1. Click extension icon in Chrome toolbar
132 | 2. Should see:
133 | - ✅ **Python Server: Online**
134 | - Jobs Processed count
135 | - Latest cover letter (if generated)
136 |
137 | ---
138 |
139 | ## 🌐 Next Steps (Optional)
140 |
141 | ### Add Custom Domain + HTTPS
142 |
143 | Instead of `http://46.202.93.22:5000`, use `https://api.yourdomain.com`:
144 |
145 | 1. **Point domain to VPS**:
146 | ```
147 | A Record: api.yourdomain.com → 46.202.93.22
148 | ```
149 |
150 | 2. **Install Nginx + SSL**:
151 | ```bash
152 | ssh root@46.202.93.22
153 |
154 | # Install Nginx
155 | apt-get install -y nginx certbot python3-certbot-nginx
156 |
157 | # Configure reverse proxy
158 | cat > /etc/nginx/sites-available/upwork-api << 'EOF'
159 | server {
160 | listen 80;
161 | server_name api.yourdomain.com;
162 |
163 | location / {
164 | proxy_pass http://localhost:5000;
165 | proxy_set_header Host $host;
166 | proxy_set_header X-Real-IP $remote_addr;
167 | }
168 | }
169 | EOF
170 |
171 | ln -s /etc/nginx/sites-available/upwork-api /etc/nginx/sites-enabled/
172 | nginx -t
173 | systemctl reload nginx
174 |
175 | # Get SSL certificate
176 | certbot --nginx -d api.yourdomain.com
177 | ```
178 |
179 | 3. **Update Chrome Extension**:
180 | - Edit `chrome-extension/content.js`
181 | - Change: `const API_URL = 'https://api.yourdomain.com';`
182 | - Reload extension
183 |
184 | 4. **Done!** 🎉 Now you have HTTPS!
185 |
186 | ---
187 |
188 | ## 🔐 Security Considerations
189 |
190 | ### Current Setup (Good for Testing)
191 | - ✅ API running on production server
192 | - ✅ Docker container with auto-restart
193 | - ⚠️ HTTP only (no SSL)
194 | - ⚠️ No rate limiting
195 | - ⚠️ CORS allows all origins
196 |
197 | ### Production Hardening (Recommended)
198 |
199 | 1. **Add HTTPS** (see above)
200 | 2. **Add Rate Limiting**:
201 | - Edit `extension_server.py`
202 | - Add flask-limiter
203 | 3. **Restrict CORS**:
204 | - Only allow your Chrome extension ID
205 | 4. **Add Authentication** (if sharing with team):
206 | - API keys for access control
207 |
208 | See `DEPLOYMENT.md` for detailed security setup.
209 |
210 | ---
211 |
212 | ## 💰 Cost Breakdown
213 |
214 | ### Monthly Costs
215 | - **Hostinger VPS**: $4.99/month (VPS 1 plan)
216 | - **Gemini AI**: FREE (1M tokens/month)
217 | - **Tavily API**: FREE (1000 searches/month)
218 | - **Domain** (optional): ~$12/year
219 |
220 | **Total**: ~$5/month for unlimited cover letter generation! 🎯
221 |
222 | ---
223 |
224 | ## 📈 Usage Limits
225 |
226 | ### Free Tier Limits
227 | - **Gemini**: 1M tokens/month ≈ **10,000-20,000 cover letters**
228 | - **Tavily**: 1000 searches/month (only used if job scraping enabled)
229 |
230 | For normal use (10-50 cover letters/day), you'll **never hit the limits**!
231 |
232 | ---
233 |
234 | ## 🐛 Troubleshooting
235 |
236 | ### Extension not working?
237 |
238 | **1. Check server is online:**
239 | ```bash
240 | curl http://46.202.93.22:5000/health
241 | ```
242 |
243 | **2. Check extension is loaded:**
244 | - Go to `chrome://extensions/`
245 | - Verify "Upwork Cover Letter Generator" is enabled
246 | - Click "Reload" button on extension
247 |
248 | **3. Check you're on a job page:**
249 | - URL should be: `https://www.upwork.com/jobs/...`
250 | - Not: search results or profile page
251 |
252 | **4. Check browser console:**
253 | - Open DevTools (F12)
254 | - Go to Console tab
255 | - Look for errors
256 |
257 | **5. Use fallback method:**
258 | ```bash
259 | python paste_job_url.py
260 | ```
261 |
262 | ---
263 |
264 | ## 📞 Support Commands
265 |
266 | ### Server Management
267 | ```bash
268 | # SSH into VPS
269 | ssh root@46.202.93.22
270 |
271 | # View running containers
272 | docker ps
273 |
274 | # View logs
275 | docker logs upwork-api -f
276 |
277 | # Restart container
278 | docker restart upwork-api
279 |
280 | # Check Docker images
281 | docker images
282 |
283 | # Remove old images (cleanup)
284 | docker system prune -a
285 | ```
286 |
287 | ### Redeploy After Code Changes
288 | ```bash
289 | # From your local machine
290 | ./deploy.sh
291 | ```
292 |
293 | ### View Generated Cover Letters
294 | ```bash
295 | ssh root@46.202.93.22 'cat /opt/upwork-api/files/cover_letter.txt | tail -100'
296 | ```
297 |
298 | ---
299 |
300 | ## 🎯 Quick Reference
301 |
302 | | What You Want | How To Do It |
303 | |---------------|--------------|
304 | | **Use extension** | Visit Upwork job → Click purple button |
305 | | **View logs** | `ssh root@46.202.93.22 'docker logs upwork-api -f'` |
306 | | **Restart server** | `ssh root@46.202.93.22 'docker restart upwork-api'` |
307 | | **Redeploy** | `./deploy.sh` |
308 | | **Check health** | `curl http://46.202.93.22:5000/health` |
309 | | **Use fallback** | `python paste_job_url.py` |
310 | | **Add HTTPS** | See "Next Steps" section above |
311 |
312 | ---
313 |
314 | ## 🎉 You're All Set!
315 |
316 | Your Upwork Cover Letter Generator is now **LIVE IN PRODUCTION**!
317 |
318 | ### What You Have:
319 | ✅ Production API on Hostinger VPS
320 | ✅ Chrome Extension connected to cloud
321 | ✅ Docker container with auto-restart
322 | ✅ Paste script as reliable fallback
323 | ✅ Deployment script for easy updates
324 |
325 | ### Start Applying!
326 | 1. Install Chrome extension
327 | 2. Visit Upwork jobs
328 | 3. Click purple button
329 | 4. Get instant AI cover letters!
330 |
331 | **Apply to 10-20 jobs per day** and watch the responses roll in! 🚀
332 |
333 | ---
334 |
335 | **Questions?** Check:
336 | - `chrome-extension/README.md` - Extension docs
337 | - `DEPLOYMENT.md` - Advanced deployment
338 | - `COMPLETE_GUIDE.md` - Full system overview
339 |
340 | **Happy job hunting!** 💼✨
341 |
--------------------------------------------------------------------------------
/DEPLOYMENT.md:
--------------------------------------------------------------------------------
1 | # Deployment Guide - Hostinger Docker Container
2 |
3 | Complete guide for deploying the Upwork Cover Letter Generator API to Hostinger using Docker.
4 |
5 | ## 🎯 Overview
6 |
7 | This guide shows how to deploy the Python Flask backend as a Docker container on Hostinger, allowing your Chrome Extension or Electron App to connect from anywhere.
8 |
9 | ## 📋 Prerequisites
10 |
11 | 1. **Hostinger VPS Plan** with Docker support
12 | 2. **Domain name** (optional but recommended)
13 | 3. **API Keys** (Tavily, Gemini)
14 | 4. **SSH access** to your Hostinger VPS
15 |
16 | ## 🚀 Deployment Methods
17 |
18 | ### Method 1: Deploy via Docker Hub (Recommended)
19 |
20 | #### Step 1: Build Docker Image Locally
21 |
22 | ```bash
23 | # Navigate to project directory
24 | cd /Users/chriscarter/Documents/GitHub/Upwork-Auto-Jobs-Applier-using-AI
25 |
26 | # Build Docker image
27 | docker build -t upwork-cover-letter-api:latest .
28 |
29 | # Test locally first
30 | docker run -p 5000:5000 --env-file .env upwork-cover-letter-api:latest
31 | ```
32 |
33 | Visit `http://localhost:5000/health` to verify it works.
34 |
35 | #### Step 2: Push to Docker Hub
36 |
37 | ```bash
38 | # Tag image
39 | docker tag upwork-cover-letter-api:latest YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
40 |
41 | # Login to Docker Hub
42 | docker login
43 |
44 | # Push image
45 | docker push YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
46 | ```
47 |
48 | #### Step 3: Deploy to Hostinger VPS
49 |
50 | ```bash
51 | # SSH into your Hostinger VPS
52 | ssh root@YOUR_VPS_IP
53 |
54 | # Pull and run the image
55 | docker pull YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
56 |
57 | # Create .env file on server
58 | cat > .env << EOF
59 | TAVILY_API_KEY=your_tavily_key
60 | GEMINI_API_KEY=your_gemini_key
61 | GROQ_API_KEY=your_groq_key
62 | EOF
63 |
64 | # Run container
65 | docker run -d \
66 | --name upwork-api \
67 | --restart unless-stopped \
68 | -p 5000:5000 \
69 | --env-file .env \
70 | YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
71 |
72 | # Check if running
73 | docker ps
74 | docker logs upwork-api
75 | ```
76 |
77 | ---
78 |
79 | ### Method 2: Deploy via Hostinger's Docker Manager
80 |
81 | If Hostinger has a Docker management interface:
82 |
83 | 1. Upload Dockerfile to VPS
84 | 2. Use Hostinger panel to build image
85 | 3. Configure environment variables in panel
86 | 4. Deploy container through UI
87 |
88 | ---
89 |
90 | ### Method 3: Git + Build on Server
91 |
92 | #### Step 1: Push Code to GitHub
93 |
94 | ```bash
95 | # Initialize git repo (if not already)
96 | git init
97 | git add .
98 | git commit -m "Add Docker deployment files"
99 |
100 | # Push to GitHub
101 | git remote add origin https://github.com/YOUR_USERNAME/upwork-cover-letter-api.git
102 | git push -u origin main
103 | ```
104 |
105 | #### Step 2: Deploy on Hostinger
106 |
107 | ```bash
108 | # SSH to Hostinger VPS
109 | ssh root@YOUR_VPS_IP
110 |
111 | # Clone repository
112 | git clone https://github.com/YOUR_USERNAME/upwork-cover-letter-api.git
113 | cd upwork-cover-letter-api
114 |
115 | # Create .env file
116 | nano .env
117 | # Add your API keys
118 |
119 | # Build and run with Docker Compose
120 | docker-compose up -d
121 |
122 | # Check status
123 | docker-compose ps
124 | docker-compose logs -f
125 | ```
126 |
127 | ---
128 |
129 | ## 🔒 Security Best Practices
130 |
131 | ### 1. Use Environment Variables (Not .env in repo)
132 |
133 | ```bash
134 | # On Hostinger VPS, set environment variables
135 | export TAVILY_API_KEY="your_key"
136 | export GEMINI_API_KEY="your_key"
137 |
138 | # Or use Docker secrets
139 | echo "your_api_key" | docker secret create gemini_key -
140 | ```
141 |
142 | ### 2. Enable HTTPS with Nginx Reverse Proxy
143 |
144 | ```bash
145 | # Install Nginx on Hostinger
146 | apt-get update && apt-get install -y nginx certbot python3-certbot-nginx
147 |
148 | # Configure Nginx
149 | cat > /etc/nginx/sites-available/upwork-api << EOF
150 | server {
151 | listen 80;
152 | server_name api.yourdomain.com;
153 |
154 | location / {
155 | proxy_pass http://localhost:5000;
156 | proxy_set_header Host \$host;
157 | proxy_set_header X-Real-IP \$remote_addr;
158 | proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
159 | proxy_set_header X-Forwarded-Proto \$scheme;
160 | }
161 | }
162 | EOF
163 |
164 | # Enable site
165 | ln -s /etc/nginx/sites-available/upwork-api /etc/nginx/sites-enabled/
166 | nginx -t
167 | systemctl reload nginx
168 |
169 | # Get SSL certificate
170 | certbot --nginx -d api.yourdomain.com
171 | ```
172 |
173 | ### 3. Add CORS Restrictions
174 |
175 | Edit `extension_server.py`:
176 |
177 | ```python
178 | # Only allow specific origins
179 | CORS(app, origins=["chrome-extension://YOUR_EXTENSION_ID"])
180 | ```
181 |
182 | ### 4. Add Rate Limiting
183 |
184 | ```python
185 | from flask_limiter import Limiter
186 | from flask_limiter.util import get_remote_address
187 |
188 | limiter = Limiter(
189 | app,
190 | key_func=get_remote_address,
191 | default_limits=["100 per hour"]
192 | )
193 |
194 | @app.route('/generate-cover-letter', methods=['POST'])
195 | @limiter.limit("10 per minute")
196 | def generate_cover_letter():
197 | # existing code
198 | ```
199 |
200 | ---
201 |
202 | ## 🔧 Managing the Container
203 |
204 | ### View Logs
205 |
206 | ```bash
207 | docker logs upwork-api -f
208 | ```
209 |
210 | ### Restart Container
211 |
212 | ```bash
213 | docker restart upwork-api
214 | ```
215 |
216 | ### Update to New Version
217 |
218 | ```bash
219 | # Pull latest image
220 | docker pull YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
221 |
222 | # Stop old container
223 | docker stop upwork-api
224 | docker rm upwork-api
225 |
226 | # Run new container
227 | docker run -d --name upwork-api -p 5000:5000 --env-file .env YOUR_DOCKERHUB_USERNAME/upwork-cover-letter-api:latest
228 | ```
229 |
230 | ### Monitor Resources
231 |
232 | ```bash
233 | docker stats upwork-api
234 | ```
235 |
236 | ---
237 |
238 | ## 🌐 Updating Chrome Extension for Production
239 |
240 | After deploying to Hostinger, update the Chrome Extension:
241 |
242 | 1. Edit `chrome-extension/content.js`:
243 |
244 | ```javascript
245 | // Change this line
246 | const API_URL = 'https://api.yourdomain.com'; // Was 'http://localhost:5000'
247 | ```
248 |
249 | 2. Reload extension in Chrome
250 | 3. Test on Upwork job page
251 |
252 | ---
253 |
254 | ## 📊 Monitoring & Maintenance
255 |
256 | ### Health Check Endpoint
257 |
258 | ```bash
259 | curl https://api.yourdomain.com/health
260 | ```
261 |
262 | Should return:
263 | ```json
264 | {
265 | "status": "ok",
266 | "message": "Server is running",
267 | "jobs_processed": 42
268 | }
269 | ```
270 |
271 | ### Set Up Uptime Monitoring
272 |
273 | Use services like:
274 | - UptimeRobot (free)
275 | - Pingdom
276 | - StatusCake
277 |
278 | Monitor: `https://api.yourdomain.com/health`
279 |
280 | ### Backup Strategy
281 |
282 | ```bash
283 | # Backup generated cover letters
284 | docker exec upwork-api tar czf /tmp/backup.tar.gz /app/files
285 | docker cp upwork-api:/tmp/backup.tar.gz ./backups/
286 | ```
287 |
288 | ---
289 |
290 | ## 💰 Cost Estimates
291 |
292 | ### Hostinger VPS Pricing
293 | - **VPS 1**: $4.99/month (1 vCPU, 4GB RAM) - ✅ Recommended
294 | - **VPS 2**: $8.99/month (2 vCPU, 8GB RAM) - For high traffic
295 |
296 | ### API Costs
297 | - **Gemini 2.0 Flash**: Free tier includes 1M tokens/month
298 | - **Tavily API**: Free tier includes 1000 searches/month
299 |
300 | **Estimated Total**: $5-10/month
301 |
302 | ---
303 |
304 | ## 🐛 Troubleshooting
305 |
306 | ### Container won't start
307 |
308 | ```bash
309 | # Check logs
310 | docker logs upwork-api
311 |
312 | # Common issues:
313 | # - Missing API keys in .env
314 | # - Port 5000 already in use
315 | # - Insufficient memory
316 | ```
317 |
318 | ### API unreachable from extension
319 |
320 | 1. Check firewall: `ufw allow 5000`
321 | 2. Verify CORS settings
322 | 3. Check Nginx configuration
323 | 4. Test with curl: `curl http://YOUR_VPS_IP:5000/health`
324 |
325 | ### Out of memory
326 |
327 | ```bash
328 | # Increase container memory limit
329 | docker run -d --memory="1g" --name upwork-api ...
330 | ```
331 |
332 | ---
333 |
334 | ## 📝 Production Checklist
335 |
336 | - [ ] Docker image built and tested locally
337 | - [ ] Image pushed to Docker Hub
338 | - [ ] Container running on Hostinger VPS
339 | - [ ] Environment variables configured
340 | - [ ] Health check endpoint accessible
341 | - [ ] HTTPS enabled with SSL certificate
342 | - [ ] CORS configured for extension origin
343 | - [ ] Rate limiting enabled
344 | - [ ] Uptime monitoring configured
345 | - [ ] Backup strategy implemented
346 | - [ ] Chrome extension updated with production URL
347 | - [ ] Extension tested with production API
348 |
349 | ---
350 |
351 | ## 🎉 Success!
352 |
353 | Your Upwork Cover Letter Generator API is now running in production on Hostinger!
354 |
355 | Users can now use the Chrome Extension or Electron App from anywhere to generate cover letters.
356 |
357 | For support, check the main README or open an issue on GitHub.
358 |
--------------------------------------------------------------------------------
/extension_server.py:
--------------------------------------------------------------------------------
1 | """
2 | Flask server for Chrome Extension
3 | Receives job data from extension and generates cover letters
4 | """
5 | from flask import Flask, request, jsonify
6 | from flask_cors import CORS
7 | from dotenv import load_dotenv
8 | from src.utils import read_text_file
9 | from src.agent import Agent
10 | from src.prompts import generate_cover_letter_prompt
11 | import json
12 | import re
13 |
14 | load_dotenv()
15 |
16 | app = Flask(__name__)
17 | # Enable CORS for Chrome extension and browsers
18 | CORS(app, resources={
19 | r"/*": {
20 | "origins": "*",
21 | "methods": ["GET", "POST", "OPTIONS"],
22 | "allow_headers": ["Content-Type"],
23 | "expose_headers": ["Content-Type"],
24 | "supports_credentials": False
25 | }
26 | })
27 |
28 | # Load profile once on startup
29 | print("📋 Loading profile...")
30 | profile = read_text_file("./files/profile.md")
31 | print(f"✅ Profile loaded ({len(profile)} characters)")
32 |
33 | # Initialize AI agent
34 | print("🤖 Initializing AI agent...")
35 | agent = Agent(
36 | name="Cover Letter Generator",
37 | model="gemini/gemini-2.0-flash-exp",
38 | system_prompt=generate_cover_letter_prompt.format(profile=profile),
39 | temperature=0.1
40 | )
41 | print("✅ Agent ready!")
42 |
43 | # Counter for jobs processed
44 | jobs_processed = 0
45 |
46 | @app.route('/', methods=['GET'])
47 | def home():
48 | """Welcome page with API documentation"""
49 | return """
50 |
51 |
52 |
53 | Upwork Cover Letter Generator API
54 |
101 |
102 |
103 |
104 |
🤖 Upwork Cover Letter Generator API
105 |
✅ Server is running
106 |
107 |
AI-powered cover letter generation for Upwork jobs using Gemini 2.0 Flash.
108 |
109 |
110 |
GET /health
111 |
Health check endpoint
112 |
curl http://46.202.93.22:5000/health
113 |
114 |
115 |
116 |
POST /generate-cover-letter
117 |
Generate personalized cover letter from job data
118 |
Request body:
119 |
120 | {
121 | "title": "Job Title",
122 | "description": "Job description...",
123 | "budget": "$50-100/hr",
124 | "experience_level": "Expert"
125 | }
126 |
127 |
128 |
129 |
130 |
131 |
""" + str(jobs_processed) + """
132 |
Jobs Processed
133 |
134 |
135 |
✅
136 |
Status
137 |
138 |
139 |
140 |
141 | 📖 Documentation |
142 | 🔧 Health Check
143 |
144 |