{"id":50777145,"url":"https://github.com/kasra-dastranj/resume-analyzer","last_synced_at":"2026-06-12T00:31:22.508Z","repository":{"id":325609187,"uuid":"1101799856","full_name":"kasra-dastranj/resume-analyzer","owner":"kasra-dastranj","description":"📄 AI-Powered Resume Analyzer with Groq - تحلیل هوشمند رزومه با هوش مصنوعی برای استخدام بازرس صنایع نفت و گاز آموزش دیده و طراحی شده","archived":false,"fork":false,"pushed_at":"2025-11-22T09:24:34.000Z","size":14,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-22T11:19:51.795Z","etag":null,"topics":["ai","groq","machine-learning","nlp","python","resume-analyzer","streamlit"],"latest_commit_sha":null,"homepage":"https://huggingface.co/spaces/Kasradastranj/resume-analyzer-space","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kasra-dastranj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-22T09:03:39.000Z","updated_at":"2025-11-22T09:20:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kasra-dastranj/resume-analyzer","commit_stats":null,"previous_names":["kasra-dastranj/resume-analyzer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kasra-dastranj/resume-analyzer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasra-dastranj%2Fresume-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasra-dastranj%2Fresume-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasra-dastranj%2Fresume-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasra-dastranj%2Fresume-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kasra-dastranj","download_url":"https://codeload.github.com/kasra-dastranj/resume-analyzer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kasra-dastranj%2Fresume-analyzer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34224103,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","groq","machine-learning","nlp","python","resume-analyzer","streamlit"],"created_at":"2026-06-12T00:31:19.174Z","updated_at":"2026-06-12T00:31:21.985Z","avatar_url":"https://github.com/kasra-dastranj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📄 Resume Analyzer - AI-Powered CV Analysis\n\nیک ابزار هوشمند برای تحلیل و ارزیابی رزومه‌ها با استفاده از هوش مصنوعی Groq\n\n![Python](https://img.shields.io/badge/python-3.9+-blue.svg)\n![Streamlit](https://img.shields.io/badge/streamlit-1.46+-red.svg)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n\n---\n\n## ✨ ویژگی‌ها\n\n- 🤖 **تحلیل هوشمند**: استفاده از Groq AI برای تحلیل دقیق رزومه‌ها\n- 📊 **گزارش جامع**: تولید گزارش‌های ساختاریافته و بهینه\n- 📁 **پشتیبانی از فرمت‌های مختلف**: PDF, DOCX, تصاویر\n- 🚀 **رابط کاربری ساده**: با Streamlit\n- ⚡ **پردازش بهینه**: مدیریت هوشمند فایل‌های بزرگ\n- 🔄 **پردازش دسته‌ای**: تحلیل چندین رزومه به صورت همزمان\n\n---\n\n## 🚀 نصب و راه‌اندازی\n\n### پیش‌نیازها\n\n- Python 3.9 یا بالاتر\n- API Key از [Groq](https://groq.com)\n\n### مراحل نصب\n\n```bash\n# 1. کلون کردن پروژه\ngit clone https://github.com/kasra-dastranj/resume-analyzer.git\ncd resume-analyzer\n\n# 2. ساخت محیط مجازی\npython -m venv .venv\nsource .venv/bin/activate  # Linux/Mac\n.venv\\Scripts\\activate     # Windows\n\n# 3. نصب وابستگی‌ها\npip install -r requirements.txt\n\n# 4. اجرا\nstreamlit run streamlit_app.py\n```\n\n---\n\n## 🎮 نحوه استفاده\n\n### 1️⃣ دریافت API Key\n\n1. برو به [Groq Console](https://console.groq.com)\n2. ثبت‌نام کن یا لاگین کن\n3. API Key بساز\n4. کپی کن\n\n### 2️⃣ اجرای برنامه\n\n```bash\nstreamlit run streamlit_app.py\n```\n\n### 3️⃣ آپلود رزومه\n\n1. API Key خودت رو وارد کن\n2. فایل‌های رزومه رو آپلود کن (PDF, DOCX, یا تصویر)\n3. روی \"Analyze\" کلیک کن\n4. منتظر تحلیل بمون\n5. گزارش‌ها رو دانلود کن\n\n---\n\n## 📁 ساختار پروژه\n\n```\nresume-analyzer/\n├── streamlit_app.py              # فایل اصلی Streamlit\n├── cv_parser.py                  # پارسر رزومه‌ها\n├── optimized_report_generator.py # تولید گزارش بهینه\n├── requirements.txt              # وابستگی‌های Python\n├── README.md                     # این فایل\n└── .gitignore                    # فایل‌های نادیده گرفته شده\n```\n\n---\n\n## 🔧 تنظیمات\n\n### فرمت‌های پشتیبانی شده\n\n- **PDF**: فایل‌های PDF استاندارد\n- **DOCX**: اسناد Word\n- **تصاویر**: PNG, JPG, JPEG (با OCR)\n\n### محدودیت‌ها\n\n- حداکثر حجم فایل: 10MB\n- فرمت‌های پشتیبانی شده: PDF, DOCX, PNG, JPG\n\n---\n\n## 🤝 مشارکت\n\nاز مشارکت شما استقبال می‌کنیم!\n\n1. Fork کنید\n2. Branch جدید بسازید (`git checkout -b feature/amazing-feature`)\n3. تغییرات رو Commit کنید (`git commit -m 'feat: add amazing feature'`)\n4. Push کنید (`git push origin feature/amazing-feature`)\n5. Pull Request بسازید\n\n📖 [راهنمای مشارکت](CONTRIBUTING.md)\n\n---\n\n## 📊 نمونه خروجی\n\nبرنامه این اطلاعات رو از رزومه استخراج می‌کنه:\n\n- ✅ اطلاعات شخصی\n- ✅ تحصیلات\n- ✅ تجربیات کاری\n- ✅ مهارت‌ها\n- ✅ پروژه‌ها\n- ✅ زبان‌ها\n- ✅ گواهینامه‌ها\n\n---\n\n## 🐛 مشکلات رایج\n\n### خطای API Key\n```\n❌ Error initializing API clients\n```\n**راه‌حل**: مطمئن شو API Key درست وارد شده\n\n### خطای OCR\n```\n❌ Tesseract not found\n```\n**راه‌حل**: \n```bash\n# Windows\n# دانلود از: https://github.com/UB-Mannheim/tesseract/wiki\n\n# Linux\nsudo apt install tesseract-ocr\n\n# Mac\nbrew install tesseract\n```\n\n---\n\n## 📄 مجوز\n\nاین پروژه تحت مجوز MIT منتشر شده. [LICENSE](LICENSE)\n\n---\n\n## 🙏 تشکر\n\n- [Groq](https://groq.com) - AI API\n- [Streamlit](https://streamlit.io) - Web Framework\n- [PDFPlumber](https://github.com/jsvine/pdfplumber) - PDF Parser\n- [python-docx](https://python-docx.readthedocs.io) - DOCX Parser\n\n---\n\n## 📞 ارتباط\n\n- **GitHub**: [@kasra-dastranj](https://github.com/kasra-dastranj)\n- **Email**: kasra.dastranj80@gmail.com\n- **Hugging Face**: [Resume Analyzer Space](https://huggingface.co/spaces/Kasradastranj/resume-analyzer-space)\n\n---\n\n## 🌟 Demo\n\n🚀 **Live Demo**: [Hugging Face Space](https://huggingface.co/spaces/Kasradastranj/resume-analyzer-space)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**ساخته شده با ❤️ توسط Kasra Dastranj**\n\n⭐ اگه این پروژه بهت کمک کرد، یه ستاره بهش بده!\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasra-dastranj%2Fresume-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkasra-dastranj%2Fresume-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasra-dastranj%2Fresume-analyzer/lists"}