{"id":22082925,"url":"https://github.com/theihasan/geezap","last_synced_at":"2025-07-24T16:30:49.142Z","repository":{"id":248471433,"uuid":"818488150","full_name":"theihasan/geezap","owner":"theihasan","description":"Geezap is an AI-powered job aggregation platform built with Laravel that unifies job listings from LinkedIn, Upwork, Indeed, and ZipRecruiter. Features include smart job matching, automated cover letter generation, and application tracking.","archived":false,"fork":false,"pushed_at":"2024-11-29T18:48:02.000Z","size":9284,"stargazers_count":3,"open_issues_count":7,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-29T19:36:00.073Z","etag":null,"topics":["ai-powered-job-search","cover-letter-generator","job-aggregator","laravel","livewire","mysql","openai-api","php","reverb","tailwindcss","websocket"],"latest_commit_sha":null,"homepage":"http://geezap.com","language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theihasan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-06-22T01:30:11.000Z","updated_at":"2024-11-29T18:52:14.000Z","dependencies_parsed_at":"2024-11-29T19:29:09.409Z","dependency_job_id":"1c6301f7-7840-4044-939a-69224f421857","html_url":"https://github.com/theihasan/geezap","commit_stats":null,"previous_names":["theihasan/geezap"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theihasan%2Fgeezap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theihasan%2Fgeezap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theihasan%2Fgeezap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theihasan%2Fgeezap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theihasan","download_url":"https://codeload.github.com/theihasan/geezap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227456457,"owners_count":17777940,"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","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-powered-job-search","cover-letter-generator","job-aggregator","laravel","livewire","mysql","openai-api","php","reverb","tailwindcss","websocket"],"created_at":"2024-12-01T00:08:16.635Z","updated_at":"2025-07-24T16:30:49.131Z","avatar_url":"https://github.com/theihasan.png","language":"Blade","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Details Documentation](https://deepwiki.com/badge.svg)](https://deepwiki.com/theihasan/geezap)\n\n![Free Palestine](https://github.com/user-attachments/assets/2b796609-c819-4cf6-b454-993e47a6e0f2)\n\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e🎯 Geezap-Job Aggregator\u003c/h1\u003e\n  \u003cp\u003eA comprehensive job aggregation platform that brings opportunities from multiple sources into one place.\u003c/p\u003e\n\u003c/div\u003e\n\n## 📌 Project Overview\n\nGeezap-Job Aggregator is a Laravel-based application that simplifies the job search process by aggregating job listings from various platforms including:\n- LinkedIn\n- Upwork\n- Indeed\n- ZipRecruiter\n- And more...\n\nThe platform not only consolidates job listings but also provides tools to enhance the job application process and preparation.\n\n## 🚀 Key Features\n\n- **Job Aggregation**\n    - Unified search across multiple job platforms\n    - Real-time job updates\n    - Detailed job information in a standardized format\n\n- **Application Management**\n    - Track application status (Applied, Saved)\n    - Save jobs for later application\n    - Application history dashboard\n\n- **Cover Letter Generation**\n    - AI-powered cover letter generation based on job details\n    - Customizable templates\n    - Export options\n\n## 🛠️ Installation\n\n1. Clone the repository\n```bash\ngit clone https://github.com/theihasan/geezap.git\ncd geezap\n```\n\n2. Install dependencies\n```bash\ncomposer install\nnpm install\n```\n\n3. Configure environment variables\n```bash\ncp .env.example .env\nphp artisan key:generate\n```\n\n4. Set up required API keys in `.env`:\n```bash\nOPENAI_API_KEY=your_openai_api_key\n\n# Cloudflare Turnstile\nCLOUDFLARE_TURNSTILE_SITE_KEY=your_site_key\nCLOUDFLARE_TURNSTILE_SECRET_KEY=your_secret_key\n```\n\u003e Also you may need to set turnstile widget from cloudflare dashboard\n\n5. Run migrations and generate application key\n```bash\nphp artisan migrate\n```\n\n6. Set up Laravel Reverb for WebSocket:\n```bash\nphp artisan reverb:install\nphp artisan reverb:start\n```\n\n7. Start the development server\n```bash\nphp artisan serve\nnpm run dev\n```\n\n8. Add Job Category\n- Add a job category via the admin panel: `/geezap/job-categories`.\n- Admin credential are available in the seeder class\n\n9. Add API-Key\n- Add API Keys for job search via admin panel: `/geezap/api-keys`.\n\n10. Run the Scheduler\n```bash\nphp artisan schedule:run\n```\n\n1.   Run the queue worker\n```bash\nphp artisan queue:work\n```\n\n**Notes**\n- If you don't get expected behavior check `laravel.log` file\n- Following command might be helpful in some cases\n```bash\nphp artisan cache:clear\n```\n\n## 💻 Technologies Used\n\n- Laravel 11.x\n- Laravel Reverb for WebSocket\n- OpenAI API\n- MySQL\n- Livewire (Frontend)\n- TailwindCSS\n\n## 📧 Email Communications\n\nGeezap sends emails to users at various touchpoints throughout their journey:\n\n1. **User Registration**\n    - Welcome email when a new user signs up\n\n2. **Password Management**\n    - Password reset links when requested\n\n3. **Job Alerts**\n    - Weekly job digest with personalized job recommendations\n\nAll emails are sent using a failover configuration that ensures reliable delivery through multiple providers. Users can manage their email preferences through their account settings.\n\n## Current Feature\n  - It collect techical jobs from Bangladesh, India, Australia, UK, USA, Thailand and show this portal\n  - User can generate a darft cover letter from job details page.\n  - User get weekly digest in their email.\n  - User get push notification.\n  - Apply button click history.\n  - Save job for letter apply.\n  - Social Authentication via Github, Google. Facebook ongoing.\n  - Bot protection using Cloudflare turnstile.\n  - Better filtering options in browse job page.\n## 🔜 Upcoming Features\n- **Personalized Job Recommendations**\n    - AI-driven suggestions based on user activity, preferences, and saved searches.\n    - AI-powered job recommendations\n    - Skill compatibility scoring\n\n- **Social Media Sharing**\n    - Share job listings on platforms like LinkedIn, Twitter, and Facebook.\n    - Auto posting to facebook\n\n- **Reminder Notification for Saved for Latter Job**\n    - When user saved a job for letter application then he will get a email notification before 2days of deadline of this job\n    - Job preference\n\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheihasan%2Fgeezap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheihasan%2Fgeezap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheihasan%2Fgeezap/lists"}