You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
AI-powered job application automation platform that transforms hours of manual work into minutes of intelligent automation.
ApplyBot automates your entire job search pipeline: discovers relevant jobs, generates tailored resumes and cover letters, sends personalized applications via Gmail, tracks responses in Google Sheets, and automatically follows up—all powered by AI.
🎯 What It Does
Warning
The Frontend UI is currently heavily WIP. The backend is fully functional and can be tested via Swagger UI.
Discovers Jobs: Fetches from RemoteOK, CSV uploads, or manual entry
Matches Projects: AI selects your most relevant projects for each job
Generates Documents: Creates tailored LaTeX resumes and cover letters
Sends Applications: Automated Gmail sending with attachments
Tracks Everything: Google Sheets CRM for all applications
git clone https://github.com/yourusername/applybot.git
cd applybot
pip install -r requirements.txt
2. Configure Environment
Create a .env file in the project root:
# DatabaseDATABASE_URL=postgresql://user:pass@host/applybot# AI ServicesGROQ_API_KEY=your_groq_key# Gmail APIGMAIL_CLIENT_ID=your_gmail_client_idGMAIL_CLIENT_SECRET=your_gmail_client_secret# Google Sheets APISHEETS_CLIENT_ID=your_sheets_client_idSHEETS_CLIENT_SECRET=your_sheets_client_secretSHEETS_SPREADSHEET_ID=your_spreadsheet_id# ApplicationAPI_BASE_URL=http://localhost:8000ENABLE_BACKGROUND_WORKERS=true# Follow-up SettingsFOLLOWUP_DAYS_INTERVAL=5MAX_FOLLOWUP_COUNT=2REPLY_CHECK_INTERVAL_MINUTES=30
3. Initialize Database
# Run database migrations
alembic upgrade head
4. Authenticate APIs (One-Time Setup)
# Authenticate both Gmail and Sheets
./scripts/authenticate_apis.sh
# Or authenticate individually
python scripts/authenticate_sheets.py
curl http://localhost:8000/api/v1/gmail/authenticate # Open URL in browser# Verify authentication
python scripts/check_auth_status.py
5. Start the Server
# Using Make
make run
# Or directly with uvicorn
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
# Run all tests
pytest
# Run with coverage
pytest --cov=app --cov-report=html
# Run specific test file
pytest tests/integration/test_api_endpoints.py -v
Code Quality
# Format code
black app/
# Lint
flake8 app/
# Type checking
mypy app/
Database Migrations
# Create new migration
alembic revision --autogenerate -m "description"# Apply migrations
alembic upgrade head
# Rollback
alembic downgrade -1
🎨 Key Features
1. Intelligent Profile Management
Comprehensive user profiles with skills, education, experience, projects
Profile completeness scoring
Bulk data import
2. AI-Powered Matching
TF-IDF + ML algorithms for project-to-job matching
Redis caching for performance
MLflow experiment tracking
3. Document Generation
LaTeX-compiled professional PDFs
Role-specific templates
AI-powered content optimization
ATS-friendly formatting
4. Automated Email Pipeline
Gmail API integration with OAuth2
Bulk sending with rate limiting
Attachment management
Thread tracking
5. CRM & Tracking
Google Sheets integration
Status tracking (SENT → REPLIED → INTERVIEW → OFFER)
# 1. Get auth URL
curl http://localhost:8000/api/v1/gmail/authenticate
# 2. Open the URL in browser and authorize# 3. Verify
curl http://localhost:8000/api/v1/gmail/status
Put credentials/gmail_credentials.json (downloaded from Google Cloud Console) in the project root.
Add redirect URI: http://localhost:8000/api/v1/gmail/callback
Google Sheets
curl http://localhost:8000/api/v1/sheets/authenticate
# Open URL in browser, then:
curl http://localhost:8000/api/v1/sheets/status
Generate role-specific resume from user DB profile
GET
/dynamic-resume/download/{filename}
Download generated file
POST
/dynamic-resume/generate-quick
Quick demo without user account
# Get available roles
curl http://localhost:8000/api/v1/dynamic-resume/available-roles
# Generate for a specific role (requires user in DB)
curl -X POST http://localhost:8000/api/v1/dynamic-resume/generate \
-H "Content-Type: application/json" \
-d '{ "user_id": "{user_id}", "target_role": "Machine Learning Engineer", "use_ai_selection": true, "output_format": "pdf" }'# Quick demo without account
curl -X POST "http://localhost:8000/api/v1/dynamic-resume/generate-quick?target_role=Backend+Engineer&user_name=John+Doe"
# Match projects to a job
curl "http://localhost:8000/api/v1/match/{job_id}?user_id={user_id}&max_results=5&use_cache=true"# Get explanation for a specific project
curl -X POST "http://localhost:8000/api/v1/match/{job_id}/explain?project_id={project_id}&user_id={user_id}"# Cache stats
curl http://localhost:8000/api/v1/match/cache/stats
AI Features
Method
Path
Description
POST
/ai/select-projects
AI picks best projects for a job description
POST
/ai/generate-followup
Generate follow-up email using AI
GET
/ai/test-ai
Test Groq API connection
# AI project selection
curl -X POST http://localhost:8000/api/v1/ai/select-projects \
-H "Content-Type: application/json" \
-d '{ "user_id": "{user_id}", "job_title": "ML Engineer", "job_description": "We need someone experienced in PyTorch, model deployment...", "max_projects": 3 }'# Generate follow-up email
curl -X POST http://localhost:8000/api/v1/ai/generate-followup \
-H "Content-Type: application/json" \
-d '{ "original_subject": "Application for ML Engineer role", "job_title": "ML Engineer", "company_name": "Acme AI", "followup_count": 1, "user_name": "John Doe", "days_since_sent": 7 }'# Test AI
curl http://localhost:8000/api/v1/ai/test-ai
# Run full workflow from CSV
curl -X POST http://localhost:8000/api/v1/workflow/upload-jobs-csv \
-F "file=@jobs.csv"# CSV columns: job_title, company, job_link, job_description, email# Full workflow
curl -X POST http://localhost:8000/api/v1/workflow/run-full-workflow \
-H "Content-Type: application/json" \
-d '{ "user_id": "{user_id}", "user_profile": {"name": "John", "skills": ["Python"]}, "job_source": {"source": "csv", "url": null}, "options": {"template": "standard", "tone": "professional", "max_projects": 5} }'
Test Generation
Method
Path
Description
GET
/test/sample-data
Get sample user/job/project data
POST
/test/resume
Test resume agent
POST
/test/cover-letter
Test cover letter agent
POST
/test/both
Test both agents
POST
/test/quick-test
One-click test with sample data
# Get sample data to use in tests
curl http://localhost:8000/api/v1/test/sample-data
# Quick test (no input needed)
curl -X POST http://localhost:8000/api/v1/test/quick-test
# Test resume with custom data
curl -X POST http://localhost:8000/api/v1/test/resume \
-H "Content-Type: application/json" \
-d '{ "user_profile": {"name": "John", "email": "j@example.com", "skills": ["Python"]}, "job": {"title": "Backend Engineer", "company": "Acme", "description": "..."}, "matched_projects": [] }'
Test Script
Run this script to verify core endpoints work end-to-end:
python test_api_endpoints.py
The script:
Checks health endpoint
Creates a test user
Adds skill, education, experience, project
Fetches complete profile and summary
Full Workflow Example
BASE=http://localhost:8000/api/v1
# 1. Authenticate APIs (one time)
curl $BASE/gmail/authenticate # open returned URL in browser
curl $BASE/sheets/authenticate # open returned URL in browser# 2. Create user
USER=$(curl -s -X POST $BASE/users/ -H "Content-Type: application/json" \ -d '{"email":"me@example.com","full_name":"Me","phone":"+1234567890"}'| python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")# 3. Add profile data
curl -X POST "$BASE/skills/?user_id=$USER" -H "Content-Type: application/json" \
-d '{"category":"Languages","items":["Python","Go"],"display_order":0}'
curl -X POST "$BASE/projects/?user_id=$USER" -H "Content-Type: application/json" \
-d '{"title":"API Platform","description":"High-perf REST API","technologies":["Python","FastAPI","Redis"],"category":"API Development"}'# 4. Fetch jobs
curl -X POST $BASE/jobs/fetch -H "Content-Type: application/json" \
-d '{"keywords":["python","backend"],"limit_per_source":20}'# 5. Get job IDs
JOB=$(curl -s "$BASE/jobs/?keywords=python&limit=1"| python3 -c "import sys,json; d=json.load(sys.stdin); print(d[0]['id']) if d else print('')")# 6. Match projects to job
curl "$BASE/match/$JOB?user_id=$USER"# 7. Generate tailored resume
curl -X POST $BASE/resume/generate -H "Content-Type: application/json" \
-d "{\"name\":\"Me\",\"phone\":\"+1234567890\",\"location\":\"SF\",\"email\":\"me@example.com\",\"experience_years\":\"2+\",\"primary_skills\":[\"Python\"],\"education\":[],\"skills\":[],\"job_id\":\"$JOB\"}"# 8. Send job application (full pipeline)
curl -X POST $BASE/bulk-email/send-job-application -H "Content-Type: application/json" \
-d "{\"user_id\":\"$USER\",\"job_title\":\"Backend Engineer\",\"company\":\"Acme\",\"job_description\":\"Python developer...\",\"hr_email\":\"hr@acme.com\",\"generate_documents\":true}"# 9. Check tracking
curl $BASE/bulk-email/tracking-status
