Sobre el proyecto
# Job Agent
Un agente autónomo de solicitudes de empleo que automatiza todo el ciclo de búsqueda de trabajo, desde el descubrimiento hasta el seguimiento de solicitudes.
## Qué hace
Job Agent se conecta a las principales plataformas de empleo (LinkedIn, Indeed, Glassdoor, ZipRecruiter, Dice, Wellfound), descubre ofertas, las puntúa comparándolas con un perfil de candidato configurable mediante IA, adapta el currículum para cada solicitud y envía automáticamente las coincidencias de alta confianza. Las coincidencias de confianza media se ponen en cola para revisión manual a través de un panel web.
## Características principales
**Descubrimiento de empleo multiplataforma**
Compatible con LinkedIn, Indeed, Glassdoor, ZipRecruiter, Dice y Wellfound, con límite de frecuencia y gestión de sesiones por plataforma.
**Emparejamiento impulsado por IA**
Puntúa cada oferta de 0.0 a 1.0 comparándola con tu perfil usando proveedores de IA configurables: Google Gemini (gratis), Groq (gratis), Ollama (local), OpenRouter y Anthropic Claude.
**Adaptación de currículum y carta de presentación**
Genera automáticamente currículums optimizados para ATS (PDF) y cartas de presentación personalizables para cada solicitud. Admite tonos profesional, informal y formal.
**Manejo de ATS externos**
Cuando los portales de empleo redirigen a los sitios de carrera de las empresas, el agente detecta y rellena formularios en Greenhouse, Lever, Workday, Ashby y portales de solicitud genéricos. También maneja preguntas de selección y flujos de solicitud por correo electrónico.
**Autonomía por niveles**
- Puntuación ≥ 0.80: Solicitud automática
- Puntuación 0.70–0.79: Cola para revisión manual
- Puntuación < 0.70: Omitir
Los umbrales son configurables desde el panel o mediante perfiles YAML.
**Panel web**
Interfaz Flask + HTMX + Bootstrap 5 en http://127.0.0.1:5000 con páginas para resumen, ofertas, cola de revisión, solicitudes, contactos, análisis y configuración. Configura todo desde la interfaz, sin necesidad de editar archivos.
**Bots interactivos**
Bot de Telegram (long-polling, sin necesidad de URL pública) y bot de Discord (comandos de barra) para aprobar/rechazar ofertas, consultar el estado de la cola y ver estadísticas desde tu teléfono.
**Navegador anti-detección**
Usa el navegador sigiloso Camoufox con escritura similar a la humana, movimiento del ratón, retrasos aleatorios y rotación de sesiones para reducir el riesgo de detección.
**Notificaciones y contactos**
Correo electrónico (SMTP), webhooks de Slack/Discord, alertas de Telegram. Correos electrónicos fríos y solicitudes de conexión de LinkedIn generados por IA para reclutadores.
**Programación**
APScheduler con ventanas de actividad configurables (por defecto de 8 a. m. a 11 p. m.). Ejecutar una vez, con horario o en modo de prueba.
## Inicio rápido
```bash
git clone https://github.com/billmal071/job-agent.git
cd job-agent
uv sync
uv run playwright install chromium
uv run job-agent init-db
uv run job-agent dashboard
```
Visita http://127.0.0.1:5000/settings para configurar el proveedor de IA, las credenciales de las plataformas, los umbrales y las notificaciones.
## Generación de perfil
Sube tu currículum existente (PDF/DOCX) en el panel y la IA extrae habilidades, nivel de experiencia y roles objetivo para generar automáticamente un perfil buscable.
## Múltiples perfiles
Admite perfiles separados para diferentes búsquedas de empleo (por ejemplo, fullstack vs. devops), cada uno con sus propias palabras clave, ubicaciones, expectativas salariales y plantilla de currículum.
## Soporte Docker
```bash
docker compose up dashboard
# o
docker compose run --rm agent
```
## Seguridad
- Credenciales de plataformas cifradas con Fernet (clave en ~/.job-agent/fernet.key)
- Claves API en .env (ignorado por git)
- Base de datos en ~/.job-agent/agent.db (SQLite, fuera del repositorio)
- Estado del navegador persistido por separado
## Licencia
MIT
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.