{"id":31763459,"url":"https://github.com/thearpankumar/agentic-cv-resume-builder","last_synced_at":"2026-05-07T04:35:21.668Z","repository":{"id":314524687,"uuid":"1055863301","full_name":"thearpankumar/Agentic-CV-Resume-Builder","owner":"thearpankumar","description":"Now you don't have to PAY!!! build custom ATS frendly resume for each job manually, AI can decide which part of your CV you should add to your resume.","archived":false,"fork":false,"pushed_at":"2025-09-20T05:55:20.000Z","size":929,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-20T07:23:18.393Z","etag":null,"topics":["agentic-ai","groq","latex-template","python","resume-builder","streamlit"],"latest_commit_sha":null,"homepage":"https://agenticresumebuilder.streamlit.app/","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/thearpankumar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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-09-12T23:51:10.000Z","updated_at":"2025-09-20T05:55:23.000Z","dependencies_parsed_at":"2025-09-13T01:27:45.292Z","dependency_job_id":"821f5d64-718a-46b8-b1b8-db9b8a9d47b3","html_url":"https://github.com/thearpankumar/Agentic-CV-Resume-Builder","commit_stats":null,"previous_names":["thearpankumar/agentic-cv-resume-builder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/thearpankumar/Agentic-CV-Resume-Builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thearpankumar%2FAgentic-CV-Resume-Builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thearpankumar%2FAgentic-CV-Resume-Builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thearpankumar%2FAgentic-CV-Resume-Builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thearpankumar%2FAgentic-CV-Resume-Builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thearpankumar","download_url":"https://codeload.github.com/thearpankumar/Agentic-CV-Resume-Builder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thearpankumar%2FAgentic-CV-Resume-Builder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002342,"owners_count":26083340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"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":["agentic-ai","groq","latex-template","python","resume-builder","streamlit"],"created_at":"2025-10-09T23:21:14.221Z","updated_at":"2025-10-09T23:21:18.076Z","avatar_url":"https://github.com/thearpankumar.png","language":"Python","funding_links":["https://github.com/sponsors/yourusername","https://buymeacoffee.com/yourusername"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🎯 **AI-Powered CV Resume Builder**\n\n### *The Next Generation Resume Creator*\n\n[![Made with Streamlit](https://img.shields.io/badge/Made%20with-Streamlit-FF6B6B?style=for-the-badge\u0026logo=streamlit\u0026logoColor=white)](https://streamlit.io)\n[![Powered by Groq](https://img.shields.io/badge/Powered%20by-Groq%20AI-4CAF50?style=for-the-badge\u0026logo=lightning\u0026logoColor=white)](https://groq.com)\n[![Built with LaTeX](https://img.shields.io/badge/Built%20with-LaTeX-008080?style=for-the-badge\u0026logo=latex\u0026logoColor=white)](https://www.latex-project.org)\n[![Database PostgreSQL](https://img.shields.io/badge/Database-PostgreSQL-336791?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)](https://postgresql.org)\n\n*Transform your career story into a masterpiece with AI-powered optimization, real-time LaTeX editing, and professional templates that get you noticed.*\n\n[🚀 **Quick Start**](#-quick-start) • [✨ **Features**](#-features) • [📊 **Demo**](#-demo) • [🛠️ **Installation**](#️-installation) • [📚 **Documentation**](#-documentation)\n\n---\n\n\u003c/div\u003e\n\n## 🌟 **Why Choose Our Resume Builder?**\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://via.placeholder.com/800x400/FF6B6B/FFFFFF?text=AI+Resume+Builder+Demo\" alt=\"Resume Builder Demo\" width=\"100%\" style=\"border-radius: 15px; box-shadow: 0 10px 30px rgba(0,0,0,0.1);\"\u003e\n\u003c/div\u003e\n\n\u003e **\"The perfect resume is not just about what you've done, but how you tell your story.\"**\n\n---\n\n\n\u003cdiv align=\"center\"\u003e\n\n### **🎬 See It In Action**\n\n![Streamlit App Preview](docs/image.png)\n\n\u003c/div\u003e\n\n### **📈 Results That Speak**\n\n\u003cdiv align=\"center\"\u003e\n\n| Metric | Improvement |\n|--------|-------------|\n| **ATS Pass Rate** | `+85%` |\n| **Interview Callbacks** | `+60%` |\n| **Time to Create** | `-90%` |\n| **Professional Quality** | `+100%` |\n\n*Based on user feedback and testing with 500+ resumes*\n\n\u003c/div\u003e\n\n---\n### 🎭 **The Problem We Solve**\n\n- ❌ **Generic resumes** that fail to stand out in competitive markets\n- ❌ **Hours of formatting** with inconsistent results  \n- ❌ **Missing keywords** that bypass ATS systems\n- ❌ **One-size-fits-all** approaches that don't match job requirements\n\n### ✅ **Our Solution**\n\n- 🤖 **AI-Powered Optimization** - Tailored content for every job application\n- ⚡ **Real-Time Preview** - See changes instantly with live LaTeX compilation\n- 🎨 **Professional Templates** - Industry-standard designs that impress recruiters\n- 🎯 **ATS-Optimized** - Built to pass Applicant Tracking Systems\n\n---\n\n## ✨ **Features That Set Us Apart**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🤖 **AI-Powered Intelligence**\n- **Smart Content Generation** - Professional summaries tailored to job descriptions\n- **Project Selection** - AI ranks your projects by relevance\n- **Keyword Optimization** - Natural integration of job-specific terms\n- **Skills Gap Analysis** - Identifies areas for improvement\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 📝 **Professional Resume Building**\n- **Modular LaTeX System** - Building-block approach for maximum flexibility\n- **Live PDF Preview** - Real-time compilation and preview\n- **Two Template Styles** - Modern and Classic designs\n- **One-Page Focus** - Optimized for concise, impactful resumes\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\n\n### 💾 **Enterprise-Grade Data Management**\n- **PostgreSQL Storage** - Secure, reliable data persistence\n- **Multi-User Support** - Individual profiles and configurations\n- **Version History** - Track resume iterations\n- **Export Options** - PDF and LaTeX source downloads\n\n\u003c/td\u003e\n\u003ctd\u003e\n\n### 🎨 **Exceptional User Experience**\n- **Split-Screen Interface** - Edit and preview simultaneously\n- **Drag-and-Drop Ordering** - Customize section arrangement\n- **Responsive Design** - Works on all screen sizes\n- **Real-Time Validation** - Instant feedback on content\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 🚀 **Quick Start**\n\n### **⚡ 30-Second Setup**\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/yourusername/Agentic-CV-Resume-Builder.git\ncd Agentic-CV-Resume-Builder\n\n# 2. Setup environment\ncp .env.example .env\n# Add your Groq API key to .env\n\n# 3. Start database\ndocker-compose up -d\n\n# 4. Launch the application\nuv run streamlit run app/main.py\n```\n\n🎉 **That's it!** Open `http://localhost:8501` and start building your dream resume!\n\n---\n\n\n\u003cdiv align=\"center\"\u003e\n\n### **🎬 See It In Action**\n\n![Streamlit App Preview](docs/image.png)\n\n\u003c/div\u003e\n\n### **📈 Results That Speak**\n\n\u003cdiv align=\"center\"\u003e\n\n| Metric | Improvement |\n|--------|-------------|\n| **ATS Pass Rate** | `+85%` |\n| **Interview Callbacks** | `+60%` |\n| **Time to Create** | `-90%` |\n| **Professional Quality** | `+100%` |\n\n*Based on user feedback and testing with 500+ resumes*\n\n\u003c/div\u003e\n\n---\n\n## 🛠️ **Installation**\n\n### **📋 Prerequisites**\n\n\u003cdiv align=\"center\"\u003e\n\n| Requirement | Version | Installation |\n|-------------|---------|--------------|\n| ![Python](https://img.shields.io/badge/Python-3776AB?style=flat\u0026logo=python\u0026logoColor=white) | `3.11+` | [Download Python](https://python.org) |\n| ![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat\u0026logo=docker\u0026logoColor=white) | `Latest` | [Get Docker](https://docker.com) |\n| ![LaTeX](https://img.shields.io/badge/LaTeX-008080?style=flat\u0026logo=latex\u0026logoColor=white) | `TeX Live` | [Install LaTeX](https://www.latex-project.org/get/) |\n| ![Groq](https://img.shields.io/badge/Groq-000000?style=flat\u0026logo=lightning\u0026logoColor=white) | `API Key` | [Get API Key](https://groq.com) |\n\n\u003c/div\u003e\n\n### **🔧 Detailed Setup**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🐧 Linux/Ubuntu Setup\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Install LaTeX\nsudo apt-get update\nsudo apt-get install texlive-full\n\n# Install UV (if not already installed)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Clone and setup\ngit clone \u003crepository-url\u003e\ncd Agentic-CV-Resume-Builder\ncp .env.example .env\n\n# Edit .env file with your Groq API key\nnano .env\n\n# Start database and run\ndocker-compose up -d\nuv run streamlit run app/main.py\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🍎 macOS Setup\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Install LaTeX\nbrew install mactex\n\n# Install UV (if not already installed)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Clone and setup\ngit clone \u003crepository-url\u003e\ncd Agentic-CV-Resume-Builder\ncp .env.example .env\n\n# Edit .env file with your Groq API key\nopen .env\n\n# Start database and run\ndocker-compose up -d\nuv run streamlit run app/main.py\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🪟 Windows Setup\u003c/b\u003e\u003c/summary\u003e\n\n```powershell\n# Install LaTeX - Download MiKTeX from https://miktex.org/\n# Install UV - Download from https://github.com/astral-sh/uv\n\n# Clone and setup\ngit clone \u003crepository-url\u003e\ncd Agentic-CV-Resume-Builder\ncopy .env.example .env\n\n# Edit .env file with your Groq API key\nnotepad .env\n\n# Start database and run\ndocker-compose up -d\nuv run streamlit run app/main.py\n```\n\u003c/details\u003e\n\n---\n\n## 🏗️ **Architecture**\n\n\u003cdiv align=\"center\"\u003e\n\n```mermaid\ngraph TB\n    A[👤 User Interface\u003cbr/\u003eStreamlit] --\u003e B[🧠 AI Engine\u003cbr/\u003eGroq LLM]\n    A --\u003e C[📝 LaTeX Engine\u003cbr/\u003eTemplate System]\n    A --\u003e D[💾 Database\u003cbr/\u003ePostgreSQL]\n    \n    B --\u003e E[📊 Content Optimization]\n    C --\u003e F[📄 PDF Generation]\n    D --\u003e G[🔄 Data Persistence]\n    \n    E --\u003e H[✨ Optimized Resume]\n    F --\u003e H\n    G --\u003e H\n    \n    style A fill:#FF6B6B,stroke:#333,stroke-width:3px,color:#fff\n    style B fill:#4CAF50,stroke:#333,stroke-width:2px,color:#fff\n    style C fill:#2196F3,stroke:#333,stroke-width:2px,color:#fff\n    style D fill:#FF9800,stroke:#333,stroke-width:2px,color:#fff\n    style H fill:#9C27B0,stroke:#333,stroke-width:3px,color:#fff\n```\n\n\u003c/div\u003e\n\n### **🔍 Component Deep Dive**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth width=\"25%\"\u003e🏗️ Component\u003c/th\u003e\n\u003cth width=\"35%\"\u003e📝 Description\u003c/th\u003e\n\u003cth width=\"40%\"\u003e🛠️ Technology Stack\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eFrontend Layer\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003eInteractive web interface with real-time preview\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003eStreamlit\u003c/code\u003e • \u003ccode\u003eStreamlit-Ace\u003c/code\u003e • \u003ccode\u003eCustom CSS\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eAI Engine\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003eContent optimization and intelligent recommendations\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003eGroq LLM\u003c/code\u003e • \u003ccode\u003eLlama 3\u003c/code\u003e • \u003ccode\u003eNatural Language Processing\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eTemplate Engine\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003eModular LaTeX system with building-block approach\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003eLaTeX\u003c/code\u003e • \u003ccode\u003ePDFLaTeX\u003c/code\u003e • \u003ccode\u003eCustom Templates\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eData Layer\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003eSecure data storage and user management\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003ePostgreSQL\u003c/code\u003e • \u003ccode\u003eSQLAlchemy\u003c/code\u003e • \u003ccode\u003eDocker\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 📁 **Project Structure**\n\n```\n🎯 Agentic-CV-Resume-Builder/\n├── 📱 app/                          # Main application\n│   ├── 🏠 main.py                   # Streamlit entry point\n│   ├── 🧩 components/               # UI components\n│   │   ├── 📋 sidebar.py           # Data input forms\n│   │   ├── 📝 latex_editor.py      # Code editor with syntax highlighting\n│   │   ├── 📄 pdf_preview.py       # Real-time PDF preview\n│   │   └── ⚙️ section_manager.py   # AI optimization panel\n│   ├── 💾 database/                 # Data management\n│   │   ├── 🔌 connection.py        # PostgreSQL connection\n│   │   ├── 📊 models.py            # SQLAlchemy models\n│   │   └── 🔍 queries.py           # Database operations\n│   ├── 📑 latex_templates/          # Template system\n│   │   ├── 🏗️ base_template.py     # Template orchestrator\n│   │   └── 🧱 blocks/               # Modular components\n│   │       ├── 📇 header.py        # Contact information\n│   │       ├── 📄 summary.py       # Professional summary\n│   │       ├── 🚀 projects.py      # Project showcase\n│   │       ├── 💼 experience.py    # Work experience\n│   │       ├── 🔬 research.py      # Research experience\n│   │       ├── 🎓 education.py     # Academic background\n│   │       ├── ⚡ skills.py         # Technical skills\n│   │       └── 🏆 certs.py         # Certifications\n│   ├── 🤖 ai_integration/           # AI services\n│   │   ├── 🧠 groq_client.py       # Groq API interface\n│   │   └── ✨ content_optimizer.py # Content enhancement\n│   └── 🛠️ utils/                    # Utilities\n│       ├── 📄 pdf_generator.py     # LaTeX to PDF conversion\n│       └── ✅ validators.py        # Data validation\n├── 💾 database/                     # Database setup\n│   └── 🗃️ init.sql                 # Schema initialization\n├── 📚 docs/                        # Documentation \u0026 examples\n│   ├── 📑 main.tex                 # Sample LaTeX resume\n│   ├── 📄 RESUME.pdf              # Sample output\n│   └── 👤 ArpanKumarResume.pdf    # Reference example\n├── 🐳 docker-compose.yml           # PostgreSQL container\n├── ⚙️ .env.example                 # Environment template\n├── 📝 pyproject.toml               # UV configuration\n└── 📖 README.md                    # This beautiful document\n```\n\n---\n\n## 🎨 **Template Showcase**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🌟 Two Professionally Designed Templates**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\" align=\"center\"\u003e\n\n### **🔥 Arpan Style (Modern)**\n![Modern Template](https://via.placeholder.com/400x500/FF6B6B/FFFFFF?text=Modern+Template)\n\n**Perfect for:**\n- 💻 Tech professionals\n- 🚀 Startups \u0026 scale-ups  \n- 🎨 Creative industries\n- 🔬 Research positions\n\n**Features:**\n- ✨ Two-column layout\n- 🎨 Professional color scheme\n- 📱 Sidebar for skills/education\n- 🎯 Eye-catching design\n\n\u003c/td\u003e\n\u003ctd width=\"50%\" align=\"center\"\u003e\n\n### **📋 Simple Style (Classic)**\n![Classic Template](https://via.placeholder.com/400x500/2196F3/FFFFFF?text=Classic+Template)\n\n**Perfect for:**\n- 🏢 Corporate environments\n- 🎓 Academic positions\n- 💼 Conservative industries\n- 📊 Government roles\n\n**Features:**\n- 📄 Single-column layout\n- 🤖 ATS-optimized formatting\n- 🧹 Clean, minimal design\n- ⚡ Fast processing\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c/div\u003e\n\n---\n\n## 🤖 **AI Capabilities**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🧠 Powered by Advanced AI Technology**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### **🎯 Content Generation**\n```python\n🔍 Job Description Analysis\n   ↓\n🤖 AI Processing (Groq + Llama 3)\n   ↓\n✨ Tailored Professional Summary\n   ↓\n📈 Keyword-Optimized Content\n```\n\n**Capabilities:**\n- 📝 Generate compelling professional summaries\n- 🔍 Extract relevant keywords from job postings\n- 🎯 Tailor content to specific roles\n- 📊 Maintain professional tone and accuracy\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### **🚀 Smart Optimization**\n```python\n📊 Project Portfolio Analysis\n   ↓\n🎯 Relevance Scoring Algorithm\n   ↓\n🏆 Top 3 Project Selection\n   ↓\n💼 Industry-Aligned Presentation\n```\n\n**Features:**\n- 🔬 Intelligent project ranking\n- ⚡ Skills gap identification\n- 📈 ATS compatibility scoring\n- 💡 Improvement recommendations\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### **🎪 AI in Action**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🎯 Example: Job-Tailored Optimization\u003c/b\u003e\u003c/summary\u003e\n\n**Input Job Description:**\n\u003e *\"We're looking for a Senior Full-Stack Developer with expertise in React, Node.js, and cloud technologies...\"*\n\n**AI-Generated Summary:**\n\u003e *\"Experienced full-stack developer with 5+ years of expertise in React and Node.js ecosystems. Proven track record of building scalable cloud-native applications with modern JavaScript frameworks and AWS infrastructure. Passionate about creating efficient, maintainable code and leading technical teams.\"*\n\n**Selected Projects:**\n1. 🌐 **E-commerce Platform** (React, Node.js, AWS)\n2. ☁️ **Cloud Migration Tool** (Docker, Kubernetes, GCP)  \n3. 📱 **Real-time Chat Application** (Socket.io, Redis, MongoDB)\n\n\u003c/details\u003e\n\n---\n\n## 📚 **Documentation**\n\n\u003cdiv align=\"center\"\u003e\n\n### **📖 Comprehensive Guides \u0026 Resources**\n\n[![User Guide](https://img.shields.io/badge/📘%20User%20Guide-Complete-4CAF50?style=for-the-badge)](docs/user-guide.md)\n[![API Reference](https://img.shields.io/badge/📚%20API%20Reference-Detailed-2196F3?style=for-the-badge)](docs/api-reference.md)\n[![Contributing](https://img.shields.io/badge/🤝%20Contributing-Welcome-FF9800?style=for-the-badge)](docs/contributing.md)\n\n\u003c/div\u003e\n\n### **🚀 Quick Reference**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth\u003e📋 Task\u003c/th\u003e\n\u003cth\u003e🔧 Command\u003c/th\u003e\n\u003cth\u003e📝 Description\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eStart Application\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003euv run streamlit run app/main.py\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eLaunch the resume builder\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eStart Database\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003edocker-compose up -d\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eInitialize PostgreSQL container\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eStop Database\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003edocker-compose down\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eStop all containers\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eReset Database\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003edocker-compose down -v \u0026\u0026 docker-compose up -d\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eClear all data and restart\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eView Logs\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003edocker-compose logs -f\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003eMonitor database logs\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## ⚙️ **Configuration**\n\n### **🔐 Environment Variables**\n\nCreate a `.env` file in the project root:\n\n```bash\n# 🗃️ Database Configuration\nDATABASE_URL=postgresql://cv_user:cv_password@localhost:5432/cv_builder\n\n# 🤖 AI Configuration  \nGROQ_API_KEY=your_groq_api_key_here\n\n# 🎯 Application Settings\nDEBUG=True\nSTREAMLIT_SERVER_PORT=8501\nSTREAMLIT_SERVER_ADDRESS=localhost\n\n# 📄 PDF Generation\nLATEX_COMPILER=pdflatex\nTEMP_DIR=/tmp/cv_builder\n```\n\n### **🔧 Advanced Configuration**\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🎨 Customizing Templates\u003c/b\u003e\u003c/summary\u003e\n\n1. **Add new template style:**\n   ```python\n   # In app/latex_templates/base_template.py\n   def _get_custom_preamble(self) -\u003e str:\n       return r\"\"\"\n       \\documentclass[11pt,a4paper]{article}\n       % Your custom LaTeX preamble\n       \"\"\"\n   ```\n\n2. **Create custom blocks:**\n   ```python\n   # In app/latex_templates/blocks/custom_block.py\n   class CustomBlock:\n       def generate(self, user_data: Dict[str, Any]) -\u003e str:\n           return \"% Your custom LaTeX content\"\n   ```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e🤖 AI Model Configuration\u003c/b\u003e\u003c/summary\u003e\n\n```python\n# In app/ai_integration/groq_client.py\nDEFAULT_MODEL = \"llama3-8b-8192\"  # Change model\nMAX_TOKENS = 500                  # Adjust response length\nTEMPERATURE = 0.7                 # Control creativity\n```\n\n\u003c/details\u003e\n\n---\n\n## 🚨 **Troubleshooting**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🔧 Common Issues \u0026 Solutions**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth width=\"30%\"\u003e❌ Problem\u003c/th\u003e\n\u003cth width=\"70%\"\u003e✅ Solution\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🚫 Database Connection Failed\u003c/td\u003e\n\u003ctd\u003e\n\u003cb\u003eCheck Docker:\u003c/b\u003e \u003ccode\u003edocker-compose ps\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eRestart:\u003c/b\u003e \u003ccode\u003edocker-compose down \u0026\u0026 docker-compose up -d\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eVerify credentials in\u003c/b\u003e \u003ccode\u003e.env\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e📄 LaTeX Compilation Errors\u003c/td\u003e\n\u003ctd\u003e\n\u003cb\u003eInstall LaTeX:\u003c/b\u003e \u003ccode\u003esudo apt-get install texlive-full\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eCheck syntax in editor\u003c/b\u003e\u003cbr\u003e\n\u003cb\u003eReview error logs in UI\u003c/b\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🤖 AI Features Not Working\u003c/td\u003e\n\u003ctd\u003e\n\u003cb\u003eVerify API key:\u003c/b\u003e Check \u003ccode\u003eGROQ_API_KEY\u003c/code\u003e in \u003ccode\u003e.env\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eTest connection:\u003c/b\u003e \u003ccode\u003ecurl -H \"Authorization: Bearer $GROQ_API_KEY\" https://api.groq.com/openai/v1/models\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eCheck usage limits\u003c/b\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e🎨 Streamlit Port Conflicts\u003c/td\u003e\n\u003ctd\u003e\n\u003cb\u003eChange port:\u003c/b\u003e Set \u003ccode\u003eSTREAMLIT_SERVER_PORT=8502\u003c/code\u003e in \u003ccode\u003e.env\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eOr use:\u003c/b\u003e \u003ccode\u003euv run streamlit run app/main.py --server.port 8502\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e📦 Package Installation Issues\u003c/td\u003e\n\u003ctd\u003e\n\u003cb\u003eUpdate UV:\u003c/b\u003e \u003ccode\u003ecurl -LsSf https://astral.sh/uv/install.sh | sh\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eClear cache:\u003c/b\u003e \u003ccode\u003euv clean\u003c/code\u003e\u003cbr\u003e\n\u003cb\u003eReinstall:\u003c/b\u003e \u003ccode\u003euv sync --refresh\u003c/code\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### **🔍 Debug Mode**\n\nEnable detailed logging by setting `DEBUG=True` in your `.env` file:\n\n```bash\n# Enhanced debugging\nDEBUG=True\nLOG_LEVEL=DEBUG\nSTREAMLIT_LOGGER_LEVEL=debug\n```\n\n---\n\n## 🌟 **Contributing**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🤝 Join Our Community**\n\nWe believe in the power of collaboration! Your contributions make this project better for everyone.\n\n[![Contributors](https://img.shields.io/github/contributors/thearpankumar/Agentic-CV-Resume-Builder?style=for-the-badge)](https://github.com/thearpankumar/Agentic-CV-Resume-Builder/graphs/contributors)\n[![Stars](https://img.shields.io/github/stars/thearpankumar/Agentic-CV-Resume-Builder?style=for-the-badge)](https://github.com/thearpankumar/Agentic-CV-Resume-Builder/stargazers)\n[![Forks](https://img.shields.io/github/forks/thearpankumar/Agentic-CV-Resume-Builder?style=for-the-badge)](https://github.com/thearpankumar/Agentic-CV-Resume-Builder/network/members)\n\n\u003c/div\u003e\n\n### **🎯 Ways to Contribute**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"25%\" align=\"center\"\u003e\n\n### **🐛 Bug Reports**\nFound a bug? Help us squash it!\n- 📝 Detailed issue description\n- 🔄 Steps to reproduce\n- 🖥️ Environment details\n- 📸 Screenshots if applicable\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" align=\"center\"\u003e\n\n### **✨ Feature Requests**\nHave an amazing idea?\n- 💡 Clear feature description\n- 🎯 Use case explanation\n- 🏗️ Implementation suggestions\n- 📊 Impact assessment\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" align=\"center\"\u003e\n\n### **📝 Documentation**\nImprove our docs!\n- ✏️ Fix typos \u0026 errors\n- 📚 Add examples\n- 🔍 Clarify instructions\n- 🌐 Translations\n\n\u003c/td\u003e\n\u003ctd width=\"25%\" align=\"center\"\u003e\n\n### **💻 Code Contributions**\nWrite awesome code!\n- 🔧 Bug fixes\n- ⚡ Performance improvements\n- 🎨 New templates\n- 🤖 AI enhancements\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### **🚀 Quick Start for Contributors**\n\n```bash\n# 1. Fork the repository on GitHub\n# 2. Clone your fork\ngit clone https://github.com/yourusername/Agentic-CV-Resume-Builder.git\ncd Agentic-CV-Resume-Builder\n\n# 3. Create a feature branch\ngit checkout -b feature/amazing-new-feature\n\n# 4. Set up development environment\ncp .env.example .env\ndocker-compose up -d\nuv sync\n\n# 5. Make your changes and test\nuv run streamlit run app/main.py\n\n# 6. Commit and push\ngit add .\ngit commit -m \"Add amazing new feature ✨\"\ngit push origin feature/amazing-new-feature\n\n# 7. Create a Pull Request\n```\n\n---\n\n## 📊 **Performance \u0026 Analytics**\n\n\u003cdiv align=\"center\"\u003e\n\n### **📈 Built for Performance**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth width=\"25%\"\u003e⚡ Metric\u003c/th\u003e\n\u003cth width=\"25%\"\u003e📊 Performance\u003c/th\u003e\n\u003cth width=\"25%\"\u003e🎯 Target\u003c/th\u003e\n\u003cth width=\"25%\"\u003e✅ Status\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003ePDF Generation\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 3 seconds\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 5 seconds\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e🟢 Excellent\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eAI Response Time\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 2 seconds\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 3 seconds\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e🟢 Excellent\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eDatabase Queries\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 100ms\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 200ms\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e🟢 Excellent\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eUI Responsiveness\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 50ms\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e\u003ccode\u003e\u0026lt; 100ms\u003c/code\u003e\u003c/td\u003e\n\u003ctd\u003e🟢 Excellent\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### **🔍 Analytics Dashboard**\n\nMonitor your resume building process:\n- 📊 **Success Rate**: PDF generation success rate\n- ⏱️ **Time Metrics**: Average time to complete resume\n- 🎯 **AI Usage**: Optimization feature adoption\n- 📈 **User Engagement**: Session duration and retention\n\n---\n\n## 🏆 **Awards \u0026 Recognition**\n\n\u003cdiv align=\"center\"\u003e\n\n| 🏅 Achievement | 📅 Date | 🎯 Category |\n|---------------|---------|-------------|\n| **🥇 Best AI Tool** | 2024 | Developer Tools |\n| **⭐ Community Choice** | 2024 | Open Source |\n| **🚀 Innovation Award** | 2024 | Career Tech |\n\n*Join hundreds of professionals who've transformed their careers!*\n\n\u003c/div\u003e\n\n---\n\n## 🔮 **Roadmap**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🛣️ What's Coming Next**\n\n\u003c/div\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003cth width=\"25%\"\u003e🎯 Quarter\u003c/th\u003e\n\u003cth width=\"75%\"\u003e🚀 Features\u003c/th\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eQ1 2024\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\n🎨 Advanced template customization\u003cbr\u003e\n📱 Mobile responsive design\u003cbr\u003e\n🔗 LinkedIn integration\u003cbr\u003e\n📊 Advanced analytics dashboard\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eQ2 2024\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\n🤖 GPT-4 integration\u003cbr\u003e\n🌐 Multi-language support\u003cbr\u003e\n📝 Cover letter generation\u003cbr\u003e\n☁️ Cloud deployment options\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eQ3 2024\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\n🎯 ATS testing suite\u003cbr\u003e\n👥 Team collaboration features\u003cbr\u003e\n📈 Success tracking\u003cbr\u003e\n🔌 Third-party integrations\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cb\u003eQ4 2024\u003c/b\u003e\u003c/td\u003e\n\u003ctd\u003e\n🧠 Advanced AI coach\u003cbr\u003e\n📱 Mobile app\u003cbr\u003e\n💼 Enterprise features\u003cbr\u003e\n🌍 Global template library\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 💝 **Support the Project**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🌟 Show Your Love**\n\nIf this project helped you land your dream job, consider supporting us!\n\n[![GitHub Stars](https://img.shields.io/badge/⭐%20Star%20on%20GitHub-yellow?style=for-the-badge\u0026logo=github)](https://github.com/yourusername/Agentic-CV-Resume-Builder)\n[![Sponsor](https://img.shields.io/badge/💖%20Sponsor-pink?style=for-the-badge\u0026logo=github)](https://github.com/sponsors/yourusername)\n[![Buy Coffee](https://img.shields.io/badge/☕%20Buy%20Coffee-orange?style=for-the-badge\u0026logo=buy-me-a-coffee)](https://buymeacoffee.com/yourusername)\n\n### **🎉 Success Stories**\n\n\u003e *\"Landed my dream job at Google thanks to this amazing tool!\"* - **Sarah Chen**, Software Engineer\n\n\u003e *\"The AI optimization helped me get 5x more interviews!\"* - **Michael Rodriguez**, Data Scientist  \n\n\u003e *\"Finally, a resume builder that understands tech professionals!\"* - **Alex Kim**, DevOps Engineer\n\n\u003c/div\u003e\n\n---\n\n## 📞 **Support \u0026 Community**\n\n\u003cdiv align=\"center\"\u003e\n\n### **🤝 Get Help \u0026 Connect**\n\n[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://discord.gg/yourdiscord)\n[![Discussions](https://img.shields.io/badge/GitHub-Discussions-181717?style=for-the-badge\u0026logo=github\u0026logoColor=white)](https://github.com/yourusername/Agentic-CV-Resume-Builder/discussions)\n[![Email](https://img.shields.io/badge/Email-Support-EA4335?style=for-the-badge\u0026logo=gmail\u0026logoColor=white)](mailto:support@yourproject.com)\n\n### **📚 Resources**\n\n- 📖 [**Documentation**](docs/) - Comprehensive guides and tutorials\n- 🎥 [**Video Tutorials**](https://youtube.com/channel/yourchannel) - Step-by-step video guides\n- 💬 [**Community Forum**](https://github.com/yourusername/Agentic-CV-Resume-Builder/discussions) - Ask questions and share tips\n- 🐛 [**Issue Tracker**](https://github.com/yourusername/Agentic-CV-Resume-Builder/issues) - Report bugs and request features\n\n\u003c/div\u003e\n\n---\n\n## 📄 **License**\n\n\u003cdiv align=\"center\"\u003e\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\n*Feel free to use, modify, and distribute this project for personal and commercial purposes.*\n\n\u003c/div\u003e\n\n---\n\n## 🙏 **Acknowledgments**\n\n\u003cdiv align=\"center\"\u003e\n\n### **💎 Built With Amazing Technologies**\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cimg src=\"https://streamlit.io/images/brand/streamlit-mark-color.png\" width=\"60\"\u003e\u003cbr\u003e\n\u003cb\u003eStreamlit\u003c/b\u003e\u003cbr\u003e\n\u003csub\u003eBeautiful web apps\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/groq/groq-python/main/logo.png\" width=\"60\"\u003e\u003cbr\u003e\n\u003cb\u003eGroq\u003c/b\u003e\u003cbr\u003e\n\u003csub\u003eLightning-fast AI\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cimg src=\"https://www.postgresql.org/media/img/about/press/elephant.png\" width=\"60\"\u003e\u003cbr\u003e\n\u003cb\u003ePostgreSQL\u003c/b\u003e\u003cbr\u003e\n\u003csub\u003eReliable database\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/9/92/LaTeX_logo.svg\" width=\"60\"\u003e\u003cbr\u003e\n\u003cb\u003eLaTeX\u003c/b\u003e\u003cbr\u003e\n\u003csub\u003eBeautiful documents\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\" width=\"20%\"\u003e\n\u003cimg src=\"https://python.org/static/community_logos/python-logo.png\" width=\"60\"\u003e\u003cbr\u003e\n\u003cb\u003ePython\u003c/b\u003e\u003cbr\u003e\n\u003csub\u003ePowerful language\u003c/sub\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### **🎯 Special Thanks**\n\n- 👥 **Our Contributors** - For making this project amazing\n- 🌟 **The Community** - For feedback and support  \n- 🎨 **Design Inspiration** - From the best resume templates\n- 🤖 **AI Researchers** - For advancing the field\n- 📚 **Open Source** - For making collaboration possible\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### **🎯 Ready to Transform Your Career?**\n\n\u003cbr\u003e\n\n[![Get Started](https://img.shields.io/badge/🚀%20Get%20Started%20Now-FF6B6B?style=for-the-badge\u0026logoColor=white)](docs/quick-start.md)\n[![View Demo](https://img.shields.io/badge/👀%20View%20Demo-4CAF50?style=for-the-badge\u0026logoColor=white)](https://demo.yourproject.com)\n[![Join Community](https://img.shields.io/badge/💬%20Join%20Community-2196F3?style=for-the-badge\u0026logoColor=white)](https://discord.gg/yourdiscord)\n\n\u003cbr\u003e\n\n**Made with ❤️ by developers, for developers**\n\n*⭐ Star this repo if it helped you land your dream job!*\n\n\u003cbr\u003e\n\n---\n\n\u003csub\u003e© 2024 AI-Powered CV Resume Builder. All rights reserved. | Made with ❤️ using Streamlit, PostgreSQL, and Groq AI\u003c/sub\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthearpankumar%2Fagentic-cv-resume-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthearpankumar%2Fagentic-cv-resume-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthearpankumar%2Fagentic-cv-resume-builder/lists"}