Aiva: Intelligent Job Search Orchestrator

Aiva is a sophisticated, multi-agent AI system designed to autonomously manage and streamline the job search lifecycle. By orchestrating a team of specialized agents, Aiva transforms the chaotic process of job hunting into a structured, data driven, and highly professional workflow.

Designed for developers and professionals who value efficiency, Aiva doesn't just find links, it researches, analyzes, formats, and delivers a comprehensive intelligence report directly to your inbox.

🚀 Capabilities

Aiva operates as a cohesive unit of four specialized agents, each handling a critical phase of the operation:

1. Job Search & Analysis:

   • Scans the web for real-time job openings based on your specific role and location (e.g., Remote, Lahore).
   • Calculates a "Fit Score" (0-100) by comparing your profile against job descriptions.
   • Deep Research: If contact info is missing, it actively searches the internet to find HR or Recruiter details.

2. Professional Reporting:

   • Generates a modern, corporate-grade A4 PDF Report.
   • Includes essential details: Source URLs, Full Descriptions, Stipends/Salaries.
   • Adds value with "How to Apply" guides (including custom DM templates) and "Interview Prep" Q&A tailored to each specific role.

3. Cloud Integration:

   • Seamlessly handles file operations by uploading generated reports to ImageKit for secure, persistent hosting.

4. Executive Delivery:

   • Compiles the final intelligence package into a high-end email.
   • Delivers a direct download link via Resend, ensuring you have immediate access to your opportunities.

🧠 The Agentic Team

• JobSearchAgent (Research Lead): Responsible for finding high quality leads and ensuring data completeness.
• ReportCreationAgent (Report Generator): Transforms raw data into a visually appealing and readable PDF asset.
• FileUploadAgent (Cloud Manager): Manages the migration of local assets to the cloud.
• EmailSendingAgent (Email Reporter): Ensures the final product reaches you with a professional presentation.

🛠️ Technology Stack

• Framework: AutoGen (Agent Orchestration)
• Intelligence: Azure OpenAI (GPT-4o-mini)
• Search Engine: Tavily API
• Document Engine: WeasyPrint
• Cloud Storage: ImageKit
• Email Service: Resend
• Language: Python

⚡ Quick Start

Prerequisites

Ensure you have Python installed. This project manages dependencies using uv (recommended) or pip.

1. Configuration

1. Clone the repository.
2. Copy .env.example to .env.
3. Fill in your API keys:
   • AZURE_OPENAI_KEY & AZURE_OPENAI_ENDPOINT
   • TAVILY_API_KEY (Search)
   • RESEND_API_KEY (Email)
   • IMAGEKIT_PRIVATE_KEY (Storage)
   • EMAIL (Your receiving email address)

2. Personalization

Open app/config.py to customize:

• user_profile: Define your skills, experience, and career goals. This drives the "Fit Score" and application advice.
• job_roles: List the exact job titles you want Aiva to hunt for.
• country / city: Set your target location.

3. Execution

Run the main orchestration script:

# Using uv (Recommended)
uv run main.py

# Or standard Python
python main.py

Aiva will process each job role sequentially to ensure high-quality output, printing its progress to the console.

📜 License

MIT