recruit-agent

Minimal MVP for a recruiting agent using Google ADK + Gmail API + Telegram.

What it does

• email-agent: fetches Gmail messages from the last hour, extracts the body, and screens resumes.
• notify-agent: sends a summary to a Telegram group.
• Orchestrated by SequentialAgent in Google ADK.

Setup

1. Create and activate a virtualenv with uv, then install:

uv venv
source .venv/bin/activate
uv pip install -e .

2. Copy .env.example and fill values:

cp .env.example .env

The app loads .env automatically via python-dotenv.

3. Run with ADK (dev UI or CLI):

adk run recruit_agent

Or run the one-shot CLI:

recruit-agent

Notes

• Gmail token is stored locally at GMAIL_TOKEN_PATH after first OAuth.
• For internal use, keep OAuth in test mode and add your account as a tester.