ResumeAI is a free, open-source web app that helps job seekers — especially freshers — build, check, and improve their resumes using AI. It checks how well your resume passes ATS (Applicant Tracking System) filters used by companies to screen candidates automatically.
Built by a BCA student, for students and freshers. No paid plans. No data stored. Ever.
| Feature | Description |
|---|---|
| 📊 ATS Score Checker | Upload your resume + job description → get an AI score out of 100 with detailed feedback |
| ✍️ Resume Builder | Fill in your details → AI writes a professional ATS-optimized resume |
| 🔧 Resume Improver | Upload your existing resume → AI rewrites it with stronger language |
| 🎯 Job Match Finder | AI analyzes your resume and suggests best-fit job roles |
| 💡 Role-Specific Tips | Enter any job title → get 8 tailored resume tips |
| ⬇️ DOCX Download | Download your resume as a formatted Word document instantly |
Check Resume Tab — ATS Score with visual ring indicator
Build Resume Tab — Form-based resume builder with AI generation
DOCX Output — Clean formatted Word document ready to send
- Frontend — Streamlit with custom CSS (dark navy theme, Lucide SVG icons)
- AI Engine — Groq API running Llama 3.3 70B
- Resume Parsing — pdfplumber (PDF), python-docx (DOCX)
- Document Generation — python-docx with custom DOCX formatter
- Deployment — Streamlit Cloud (auto-deploys on push)
ATS-Resume/
│
├── app.py # Main Streamlit app — all tabs and UI logic
├── ui_components.py # Hero, score card, section headers, SVG icons, CSS
├── ai_engine.py # Groq API wrapper with retry logic
├── prompts.py # All AI prompts (ATS, builder, improver, tips)
├── resume_parser.py # PDF and DOCX text extraction
├── resume_to_docx.py # Markdown → formatted Word document converter
├── ats_scoring.py # Keyword matching algorithm
├── requirements.txt # Python dependencies
└── .streamlit/
└── secrets.toml # API keys (not committed to GitHub)
git clone https://github.com/Not-muzzyy/ATS-Resume.git
cd ATS-Resumepip install -r requirements.txtCreate .streamlit/secrets.toml:
GROQ_API_KEY = "your_groq_api_key_here"Get a free Groq API key at console.groq.com — no credit card needed.
streamlit run app.pyOpen http://localhost:8501 in your browser.
| Variable | Description | Where to get it |
|---|---|---|
GROQ_API_KEY |
Groq API key for AI features | console.groq.com |
streamlit
pdfplumber
python-docx
groq
pandas
- Fork this repo
- Go to share.streamlit.io
- Connect your GitHub repo
- Set main file to
app.py - Add
GROQ_API_KEYin the Secrets section - Deploy — live in under 2 minutes
Contributions are welcome! If you find a bug or have a feature idea:
- Fork the repo
- Create a new branch —
git checkout -b feature/your-feature - Commit your changes —
git commit -m "Add your feature" - Push and open a Pull Request
- Resume preview before download
- Multiple resume templates (Modern, Classic, Minimal)
- Auto-fill builder from uploaded resume
- Before/after ATS score comparison
- Hindi language support
- Email resume to yourself
Muzzammil — BCA Final Year Student, Bellary, Karnataka
MIT License — free to use, modify, and distribute.
If this helped you — drop a ⭐ on the repo. It means a lot!
Built with ❤️ using Streamlit + Groq AI — Free Forever