{"id":33314507,"url":"https://github.com/bomzj/smart-apply","last_synced_at":"2026-06-19T09:32:08.578Z","repository":{"id":323884481,"uuid":"1094981128","full_name":"bomzj/smart-apply","owner":"bomzj","description":"AI-powered assistant to automatically apply for jobs","archived":false,"fork":false,"pushed_at":"2026-02-24T09:53:56.000Z","size":820,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-24T15:42:44.824Z","etag":null,"topics":["ai-assistant","automation","azure-openai","gmail-api","job-application","job-applier"],"latest_commit_sha":null,"homepage":"","language":"Python","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/bomzj.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-12T12:39:38.000Z","updated_at":"2026-02-24T09:54:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bomzj/smart-apply","commit_stats":null,"previous_names":["bomzj/smart-apply"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bomzj/smart-apply","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bomzj%2Fsmart-apply","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bomzj%2Fsmart-apply/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bomzj%2Fsmart-apply/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bomzj%2Fsmart-apply/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bomzj","download_url":"https://codeload.github.com/bomzj/smart-apply/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bomzj%2Fsmart-apply/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34526065,"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-19T02:00:06.005Z","response_time":61,"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-assistant","automation","azure-openai","gmail-api","job-application","job-applier"],"created_at":"2025-11-19T12:01:05.129Z","updated_at":"2026-06-19T09:32:08.570Z","avatar_url":"https://github.com/bomzj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Smart Apply\n\nSmart Apply is your AI assistant that automates the process of applying to jobs directly on company websites.\n\nIt uses **LLM** to analyze websites, understand forms, and automatically:\n- Fill out job application forms\n- Send emails via Gmail API\n- Bypasses Cloudflare protection and the Google reCAPTCHA challenge.\n\n## Setup\n\n### Option 1 - Without Docker (Recommended)\n\n**Warning:** running browser under docker is pretty slow\n\n1. Ensure you have [uv](https://docs.astral.sh/uv/) installed.\n\n2. Install `ffmpeg` on your system.\n\t- Ubuntu/Debian: `sudo apt-get install ffmpeg`\n\t- macOS (Homebrew): `brew install ffmpeg`\n\t- Windows (winget): `winget install ffmpeg`\n\n3. Install dependencies and the project in editable/development mode:\n\n```bash\nuv sync\n```\n\n\u003e This also installs `smart_apply` as an editable package, which is required for the absolute imports used throughout the codebase.\n\n### Option 2 - With Docker\n\n```bash\ndocker compose build\n```\n\n### Setup Gmail API *(valid for both options)*\n\n1. Create a Google Cloud project https://developers.google.com/workspace/guides/create-project#project\n\n2. Enable Gmail API for this project https://developers.google.com/gmail/api/quickstart/python#enable_the_api\n\n3. Configure the OAuth consent screen https://developers.google.com/gmail/api/quickstart/python#configure_the_oauth_consent_screen\n\n4. Authorize credentials for a desktop application https://developers.google.com/gmail/api/quickstart/python#authorize_credentials_for_a_desktop_application\n\n5. Install the Google client library https://developers.google.com/gmail/api/quickstart/python#install_the_google_client_library\n\n*NOTE:* to renew expired gmail auth token run the following command:\n```bash\nuv run smart_apply/gmail.py\n```\n\n## Configuration\n\n1. Rename `config.yaml.example` to `config.yaml`.\n\n2. Configure `azure_openai` section.\n\n\u003e  **NOTE**: Smart Apply uses Azure OpenAI by default, but you can switch to any LLM.\n\n3. Fill in your personal information (your full name, email, message, pdf resume, etc.) that will be used during job applications.\n\n4.  *Optional* Configure Langfuse for LLM tracing/debugging.\n\n## How to use\n\n1. Create a `urls.txt` file containing the URLs of the companies you want to apply to.\n\n\n2. Smart Apply can run **either locally or with Docker** — choose one of the options below.\n\n```bash\nuv run apply\n```\n\nOr\n\n```bash\ndocker compose up -d\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbomzj%2Fsmart-apply","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbomzj%2Fsmart-apply","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbomzj%2Fsmart-apply/lists"}