JobMonitor

KO | EN

gitlite — search

#hacktoberfest #react #typescript #rust #deep-learning #linux #docker #windows #awesome #vue #security #mcp #ios #open-source

(★ 19)

AI-powered Telegram vacancy scraper & parser using Telethon and PydanticAI.

JobMonitor Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# JobMonitor

JobMonitor — сервис с открытым исходным кодом, который ищет IT-вакансии в Telegram. Он следит за выбранными каналами, распознаёт вакансии, извлекает из них данные и сравнивает их с профилем кандидата. Пользователь получает более чистую и подходящую ему ленту.

JobMonitor начинался как учебный проект. Поэтому местами архитектура здесь серьёзнее, чем требует обычный бот. Это сделано отчасти ради практики — и просто потому, что было интересно.

**Бот:** [открыть JobMonitor](https://t.me/JobMonitorIT_BOT)

## Соберём вакансии со всех каналов

Список отслеживаемых каналов хранится в [channels_map.json](channels_map.json). Если нужного канала или направления нет, добавьте его по [инструкции](docs/CHANNELS.md).

## Возможности

- отслеживание Telegram-каналов через Telethon;
- распознавание сообщений с вакансиями;
- разбор вакансий и предпочтений кандидата с помощью ИИ;
- фильтрация вакансий по профилю пользователя;
- отправка подходящих вакансий через Telegram-бота;
- мини-приложение, метрики и мониторинг.

## Демо

## Технологии

- Python 3.12+ и `uv`;
- Aiogram, Telethon и FastAPI;
- Pydantic, PydanticAI и OpenRouter;
- PostgreSQL, SQLAlchemy и Alembic;
- Pytest, Ruff и MyPy;
- Docker Compose, Prometheus, Grafana и Logfire.

Для небольшого Telegram-бота стек выглядит внушительно. Так и есть. Если вам нужен только простой поиск вакансий, часть компонентов можно убрать — бот не обидится.

## Быстрый запуск

### Локально

```bash
cp .env.sample .env
uv sync --dev
uv run alembic upgrade head
uv run -m app.main
```

### В Docker

```bash
cp .env.sample .env
docker compose -f docker-compose.yml -f docker-compose.override.yml up -d --build
```

Подробная настройка описана в [инструкции по установке](docs/INSTALL.md).

Репозиторий можно использовать как основу для своего бота: сделайте форк, укажите токены и каналы, затем настройте фильтры, промпты и отправку вакансий.

## Разработка

Основные команды:

```bash
make install
make quality
make lint
make test
make dev-up
make obs-up
```

О правилах работы с проектом читайте в [руководстве для участников](CONTRIBUTING.md). Самый простой полезный вклад — добавить подходящий канал в `channels_map.json`.

## Безопасность

Не добавляйте в репозиторий файл `.env`, сессии Telegram, токены, ключи API и данные продакшена. Для локальной настройки используйте `.env.sample`.

Об уязвимостях сообщайте по [правилам безопасности](SECURITY.md).

## Лицензия

Проект распространяется по лицензии MIT. Текст лицензии находится в файле [LICENSE](LICENSE).

JobMonitor

JobMonitor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

JobMonitor

JobMonitor Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README