Installation

Requirements

  • Python 3.12+

  • uv (package manager)

Clone the Repository

git clone https://github.com/yourusername/talent-acquisition-agent.git
cd talent-acquisition-agent

Install Dependencies

uv sync

This will install all dependencies defined in pyproject.toml:

  • aiohttp - Async HTTP requests

  • beautifulsoup4 - HTML parsing

  • fastapi - HTTP API server

  • pydantic-settings - Configuration management

  • twilio - SMS notifications

Verify Installation

uv run python --version
uv run .\src\main.py

You should see output like:

2026-04-25 17:15:12 | INFO | job_agent | Job Agent v1.1.0 starting

Windows Installer (.exe)

For users on Windows, a standalone installer is provided that registers the services automatically and provides an uninstaller:

  1. Download JobAgentInstaller.exe from the latest GitHub Release.

  2. Double-click the installer and follow the wizard instructions (Administrator privileges required).

  3. The services (API and Search) will be installed as Windows Services.

  4. The Web UI will be accessible at http://localhost:8080/ui.

Uninstallation

To uninstall the application: 1. Go to Settings > Apps > Installed Apps. 2. Find Talent Acquisition Agent and select Uninstall. 3. The uninstaller will stop and remove the Windows services before deleting files.

Development Setup

To contribute to this project, please set up the development environment:

  1. Install development dependencies:

    uv sync

  2. Install pre-commit hooks:

    uv run pre-commit install

  3. Run checks manually:

    uv run pre-commit run --all-files

The pre-commit configuration ensures code quality remains intact.