https://github.com/unsoto/resumemate
π€ ResumeMate β a Telegram bot for resume analysis and job search. Supports PDF/DOCX, extracts skills, evaluates market readiness, suggests vacancies via HH.ru API, and generates cover letters. Demo version for learning and testing purposes only.
https://github.com/unsoto/resumemate
aiogram bot fastapi httpx pydantic pypdf2 python python-docx telegrambot
Last synced: 3 months ago
JSON representation
π€ ResumeMate β a Telegram bot for resume analysis and job search. Supports PDF/DOCX, extracts skills, evaluates market readiness, suggests vacancies via HH.ru API, and generates cover letters. Demo version for learning and testing purposes only.
- Host: GitHub
- URL: https://github.com/unsoto/resumemate
- Owner: unSoto
- License: other
- Created: 2025-10-07T12:24:27.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-10-07T12:51:37.000Z (3 months ago)
- Last Synced: 2025-10-07T14:37:57.369Z (3 months ago)
- Topics: aiogram, bot, fastapi, httpx, pydantic, pypdf2, python, python-docx, telegrambot
- Language: Python
- Homepage:
- Size: 158 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# π€ ResumeMate
AI-Powered Telegram Bot for Resume Analysis and Job Search
Automate your job search process with Artificial Intelligence
β οΈ **Warning:** This is a demo version and basic solution prototype. Not intended for production use.
---
## π¨ Important Warning
### β οΈ DEMO PROJECT
**This is not a complete product, but a demonstration prototype of the solution.**
- π§ Basic functionality to demonstrate the concept
- π Not intended for real production use
- π§ͺ Suitable for learning and testing ideas
- π« Not recommended for serious use
---
## β¨ Key Features
π Resume Analysis
- PDF and DOCX format support
- Automatic skill extraction
- Job market readiness assessment
- Improvement recommendations
π Job Search
- Smart match-score algorithm
- Integration with HH.ru API
- Pagination and easy navigation
- Skills-based filtering
π§ Cover Letters
- Personalized generation
- LLM integration (optional)
- Human-in-the-loop control
- Email integration
β Resume Audit
- A-E scale assessment
- Specific recommendations
- ATS compatibility analysis
- Optimization suggestions
---
## π Technologies
### Backend
### Bot Development
### Document Processing
### Deployment & DevOps
### Project Architecture
```mermaid
graph TB
A[Telegram Bot] --> B[FastAPI Server]
B --> C[(Resume Database)]
B --> D[AI Services]
D --> E[OpenAI API]
B --> F[HH.ru API]
B --> G[Email Service]
```
---
## π Quick Start
### π Demo Version for Testing
This project is intended exclusively for concept demonstration and learning. Do not use in production or for real tasks.
### Prerequisites
- **Python 3.8+**
- **Telegram Bot Token** (get from [@BotFather](https://t.me/botfather))
### Installation
```bash
# 1. Clone the repository
git clone https://github.com/yourusername/resumemate.git
cd resumemate
# 2. Run automatic setup
python setup.py
# 3. Configure environment variables
cp .env.example .env
# Edit .env file with your TELEGRAM_BOT_TOKEN
```
### β οΈ Important Warnings Before Launch
**Before launching, make sure:**
- The project is intended only for demo and learning
- Do not use for real resumes or job postings
- Production will require security improvements
- Store tokens and keys securely
### Launch
```bash
# Terminal 1: FastAPI server
python run_api.py
# Terminal 2: Telegram bot
python run_bot.py
```
---
## π Usage
### π― Demo Mode
The project operates in demonstration mode with limited functionality. Use only for testing and learning.
### Workflow
### Bot Commands
| Command | Description |
|---------|-------------|
| `/start` | π Start the bot and main menu |
| `/resume` | π Upload resume for analysis |
| `/search` | π Search for jobs by skills |
### Usage Examples
#### Resume Analysis
#### Job Search
**β οΈ Note:** All usage examples are for demonstration purposes. Real functions may differ from those described.
---
## π§ API Documentation
After launching the server, documentation is available at:
**http://localhost:8000/docs**
### Main Endpoints:
#### `POST /upload-resume`
Upload and process resume
#### `POST /extract-skills`
Extract skills from text
#### `GET /health`
Health check
---
## π Project Structure
```
ResumeMate/
βββ π main.py # FastAPI server
βββ π€ bot.py # Telegram bot
βββ π§ jobs.py # Job search and analysis services
βββ βοΈ setup.py # Automatic setup
βββ π run_api.py # API launch script
βββ π€ run_bot.py # Bot launch script
βββ π requirements.txt # Python dependencies
βββ π .env.example # Configuration example
βββ π README.md # Documentation
βββ π LICENSE # License
```
---
## π Competitive Advantages
| Feature | ResumeMate | Competitors |
|---------|------------|-------------|
| π€ AI Resume Analysis | β
Complete | β Limited |
| π Smart Job Search | β
With match-score | β Basic |
| π§ LLM Cover Letters | β
Personalized | β Template-based |
| β Resume Audit | β
With recommendations | β Simple assessment |
| π― Human-in-the-loop | β
Final confirmation | β Automatic sending |
---
## π Contacts
**Developer:** Vladislav Skrauch
[](https://t.me/worksoto)
[](mailto:vlskrauch@mail.ru)
### For Commercial Use
π§ **Email:** vlskrauch@mail.ru
π± **Telegram:** @worksoto
---
## π License
The project is distributed under a **custom license**. Details in the [LICENSE](LICENSE) file.
**Important:** It is forbidden to attribute the development to yourself and use for commercial purposes without written permission from the author.
---
### β If you like the project, give it a star!
**Good luck with your job search! π**
*Made with β€οΈ for the developer community*
---
## π¨ FINAL WARNING
**This is a demo project created exclusively to demonstrate technical skills and solution concept.**
β **Do not use for real tasks**
β **Do not upload confidential information**
β **Do not apply in production environment**
β
**Use only for learning and testing**
For a complete solution, contact the developer to create a production version.