🚀 JobFlow - AI-Powered Job & Event Discovery Agent

JobFlow is an autonomous AI agent built on the Fetch.ai uAgents framework that helps users discover software engineering jobs, tech events, research people, and generate personalized introduction messages. It combines LangGraph workflows, LLM-powered intelligence, and multi-agent orchestration to deliver a seamless job search and networking experience. Created by Thang Nguyen as an internship project at Fetch.ai, cohort Fall 2025

✨ Features

💼 Job Search

Intelligent Matching: Finds SWE jobs (internships & new grad) tailored to your resume
LLM-Powered Scoring: Uses Gemini to score and rank jobs based on resume fit
Smart Shortlisting: Filters jobs by role keywords and requirements
Career Insights: Provides skill gap analysis, resume tips, and application strategies
Multi-Location Support: Search by location, work mode, and specific roles

🎪 Event Finder

Event Discovery: Search tech events by location or company
Smart Ranking: Prioritizes relevant events using LLM-based scoring
Rich Details: Shows dates, locations, hosts, registration links, and pricing
Company Filtering: Find events hosted by specific companies (Google, Fetch.ai, MongoDB, etc.)

👤 People Research

Host Information: Research event hosts and speakers
AI-Generated Bios: Get concise 4-5 sentence professional bios
Credibility Checking: Validates information using multiple sources
Context-Aware: Automatically links people to their events

✉️ Introduction Generator

Personalized Messages: Generate tailored introduction messages to event hosts
Multiple Formats: Choose from Email, LinkedIn, or General formats
Context-Rich: Uses both person's bio and your background for relevance
Professional Tone: Crafted by Gemini for maximum impact

📅 Calendar Integration

One-Click Add: Generate Google Calendar URLs for events
Pre-Filled Details: Event name, date, time, location automatically populated
No API Keys Needed: Uses Google Calendar's URL scheme

🛠️ Tech Stack

Core Framework

uAgents (v0.22.5): Fetch.ai's agent framework for autonomous communication
LangGraph (v0.3.20): Stateful multi-agent orchestration
Pydantic (v2.x): Data validation and settings management

AI & LLM

Google Gemini API: Primary LLM for intent classification, parsing, and content generation
- gemini-2.5-flash for complex reasoning
- gemini-2.5-flash-lite for fast classification
Tavily Search API: Web search for people research

Data Processing

BeautifulSoup4: HTML parsing for job description scraping
Pandas: Event data processing from CSV files
Requests: HTTP client for API calls

Infrastructure

Fetch.ai Agentverse: Agent deployment and mailbox services
ASI:One: Chat interface for interacting with the agent
Python 3.11+: Core runtime environment

📁 Folder Structure

Jobflow/
├── app/                          # Main application code
│   ├── agents/                   # LangGraph agent nodes (fetcher, scorer, ranker, formatter)
│   ├── graph/                    # LangGraph workflow definitions (job, event, person, intro)
│   ├── integrations/             # External API integrations (Gemini, Tavily)
│   ├── prompts/                  # LLM prompt templates
│   ├── services/                 # Business logic (scoring, scraping, listings)
│   ├── uagent/                   # uAgent orchestrator (main entry point)
│   └── utils/                    # Utility functions (calendar URL generation)
│
├── events/                       # Event data storage
│   ├── csv/                      # Raw event CSV files by company
│   └── events.json               # Processed event database
│
├── scripts/                      # Data processing scripts
│   └── process_events.py         # CSV → JSON event processor
│
├── requirements.txt              # Python dependencies
├── .env                          # Environment variables (API keys)
└── README.md                     # This file

Key Directories Explained:

app/agents/: Individual LangGraph nodes that perform specific tasks (fetch jobs, score resumes, rank results)
app/graph/: Workflow orchestration using LangGraph (job search workflow, event workflow, person research, introduction generation)
app/uagent/: The main orchestrator agent that routes queries and communicates with ASI:One
events/: Event database with CSV sources and processed JSON output
scripts/: Utility scripts for processing event data from CSV to structured JSON

🚀 Quick Start

Prerequisites

Before you begin, ensure you have:

Python 3.11+ installed (Download here)
Git for cloning the repository
API Keys from the following services:
- Gemini API: Get your API key
- Fetch.ai Agentverse Account: Sign up here
- Tavily API: Get your API key

📥 Installation

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/Jobflow.git
cd Jobflow

2. Create a Virtual Environment

Windows:

python -m venv .venv
.venv\Scripts\activate

macOS/Linux:

python3 -m venv .venv
source .venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Set Up Environment Variables

Create a .env file in the project root:

# Windows
copy .env.example .env

# macOS/Linux
cp .env.example .env

Edit .env with your API keys:

# ============================================================================
# Gemini API (Primary LLM)
# ============================================================================
GEMINI_API_KEY=your_gemini_api_key_here

# ============================================================================
# Fetch.ai Agentverse (Agent Deployment)
# ============================================================================
AGENTVERSE_API_KEY=your_agentverse_api_key_here
ASI1_API_KEY=your_asi1_api_key_here
JOB_ORCHESTRATOR_SEED=your_unique_seed_phrase_here

# ============================================================================
# Job Listing Sources
# ============================================================================
NEW_GRAD=https://raw.githubusercontent.com/vanshb03/New-Grad-2026/main/.github/scripts/listings.json
INTERNSHIP=https://raw.githubusercontent.com/vanshb03/Summer2026-Internships/main/.github/scripts/listings.json

# ============================================================================
# Tavily Search API (People Research)
# ============================================================================
TAVILY=your_tavily_api_key_here

How to Get Your API Keys:

GEMINI_API_KEY: Visit Google AI Studio → Sign in → "Get API Key"
AGENTVERSE_API_KEY: Sign up at Agentverse → Profile → API Keys
ASI1_API_KEY: Log in to Agentverse → Navigate to ASI:One settings → Generate API Key
JOB_ORCHESTRATOR_SEED: Create a unique passphrase (e.g., "my unique jobflow agent seed 2024")
TAVILY: Sign up at Tavily → Dashboard → Copy API Key

5. Set Up Event Data (Required for Event Finder)

For the Event Finder feature to work, you need to download event data and process it:

Download Event CSV Files

Visit the Cerebral Valley Events Spreadsheet:
- 2025 Events
- 2025 Hackathons
Export as CSV:
- Open each tab (2025 Events, 2025 Hackathons)
- Click File → Download → Comma Separated Values (.csv)
- Save the files as descriptive names (e.g., cerebralvalley-2025-events.csv, cerebralvalley-2025-hackathons.csv)

Place CSV files in the events/csv/ directory:

events/
├── csv/
│   ├── cerebralvalley-2025-events.csv
│   ├── cerebralvalley-2025-hackathons.csv
│   └── ... (add more CSV files as needed)
└── events.json  # This will be generated

Process Event Data

Run the event processor script to convert CSV files into a structured JSON database:

python scripts/process_events.py

Expected Output:

Loading events from CSVs...
✅ Loaded X events from cerebralvalley-2025-events.csv
✅ Loaded X events from cerebralvalley-2025-hackathons.csv
Processing events with Gemini...
✅ Processed X events
💾 Saved to events/events.json

This will populate events/events.json with all processed event data. The Event Finder feature queries this database.

Note: You can add more event CSV files to events/csv/ and re-run the processor to update the database. The script automatically filters out past events and removes duplicates.

▶️ Running the Orchestrator

Start the JobFlow Agent

python -m app.uagent.job_orchestrator

Expected Terminal Output

You should see logs similar to this:

======================================================================
🚀 JobFlow Orchestrator - Local Agent Inspector Mode
======================================================================
Agent Address: agent1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Port: 8002
======================================================================
✅ Agent funding checked
Starting agent... Look for 'Agent inspector available at' URL in logs!

INFO:     [jobflow_orchestrator]: Starting agent with address: agent1qtur8...
INFO:     [jobflow_orchestrator]: ======================================================================
INFO:     [jobflow_orchestrator]: 🚀 JobFlow Orchestrator uAgent Starting Up
INFO:     [jobflow_orchestrator]: ======================================================================
INFO:     [jobflow_orchestrator]: Agent Name: jobflow_orchestrator
INFO:     [jobflow_orchestrator]: Agent Address: agent1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
INFO:     [jobflow_orchestrator]: Port: 8002
INFO:     [jobflow_orchestrator]: Mailbox: Enabled (ready for ASI:One)
INFO:     [jobflow_orchestrator]: ======================================================================
INFO:     [jobflow_orchestrator]: 📡 Waiting for ChatMessages from ASI:One...
INFO:     [jobflow_orchestrator]: 👀 Watch the Local Agent Inspector for message flow!
INFO:     [jobflow_orchestrator]: ======================================================================
INFO:     [jobflow_orchestrator]: Agent inspector available at https://agentverse.ai/inspect/?uri=http%3A//127.0.0.1%3A8002&address=agent1qtur8...
INFO:     [jobflow_orchestrator]: Starting server on http://0.0.0.0:8002 (Press CTRL+C to quit)

Connect to ASI:One

Copy the Agent Inspector URL from the terminal logs (starts with https://agentverse.ai/inspect/...)
Open the URL in your browser - This opens the Local Agent Inspector
Navigate to ASI:One:
- Click on Agent Profile
- Once you get to the Agent Profile, click on Chat with Agent
- OR go directly to ASI:One and enter your agent address

Start Chatting! Try these example queries:

Link to example chat: https://asi1.ai/shared-chat/96fbce02-5074-4d72-bb5a-04c8c1f742d0

💼 Job Search:
"Find intern ML Engineer roles, remote, show me 5 jobs. Resume: CS student at SJSU with Python, TensorFlow, PyTorch..."

🎪 Event Search:
"Find tech events in the Bay Area"
"Show me events Google is hosting"

👤 People Research:
"Who is Sana Wajid from Fetch.ai?"

✉️ Introduction:
"I want to introduce myself to Sana Wajid"

📅 Calendar:
"Add event 2 to my calendar"

🎯 Example Workflow

You: "Find events hosted by Google"
Agent: [Returns list of Google events with dates, locations, hosts]

You: "Who is Alexis Lê-Quôc from the event?"
Agent: [Provides AI-generated bio of Alexis]

You: "I want to introduce myself to Alexis"
Agent: "Please share your background..."

You: [Paste your resume/background]
Agent: "Which format? A) Email B) LinkedIn C) General"

You: "A"
Agent: [Generates personalized email introduction]

You: "Add event 1 to my calendar"
Agent: [Provides Google Calendar URL]

🐛 Troubleshooting

Common Issues

1. Agent Not Responding

Ensure your AGENTVERSE_API_KEY is valid
Check that the agent is running (look for "Starting server" in logs)
Try refreshing the ASI:One chat interface

2. "No jobs found"

Verify job listing URLs are accessible
Check your resume is included in the query
Try broadening your search criteria

3. API Key Errors

Confirm all API keys in .env are correct
Make sure .env is in the project root directory
Restart the agent after updating .env

4. Python Version Issues

JobFlow requires Python 3.11 or higher
Check version: python --version

📝 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

Fetch.ai for the uAgents framework and Agentverse platform
Google for Gemini API
Tavily for web search capabilities
Job listing data sourced from SimplifyJobs and (https://github.com/vanshb03) repositories
Events from https://cerebralvalley.ai/events --> https://docs.google.com/spreadsheets/d/1P6ut7vL-gXKbeDeh3nuPqBjoCupjIt87Sw7TnhumBSU/edit?gid=1781893986#gid=1781893986

📧 Contact

For questions, issues, or contributions, please open an issue on GitHub or contact the maintainer.

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
.vscode		.vscode
app		app
events		events
scripts		scripts
.gitattributes		.gitattributes
.gitignore		.gitignore
Generative AI Events [by cerebralvalley.ai] - 2025 Events.csv		Generative AI Events [by cerebralvalley.ai] - 2025 Events.csv
Generative AI Events [by cerebralvalley.ai] - 2025 Hackathons.csv		Generative AI Events [by cerebralvalley.ai] - 2025 Hackathons.csv
README.md		README.md
requirements.txt		requirements.txt

ThangKNguyen/Jobflow-AI

Folders and files

Latest commit

History

Repository files navigation