{"id":47877797,"url":"https://github.com/michael-borck/career-compass","last_synced_at":"2026-05-23T11:05:44.447Z","repository":{"id":301284131,"uuid":"1008454728","full_name":"michael-borck/career-compass","owner":"michael-borck","description":"Provides AI-powered career guidance and resume analysis through local processing on desktop.","archived":false,"fork":false,"pushed_at":"2026-05-21T02:13:34.000Z","size":4925,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T04:32:10.347Z","etag":null,"topics":["ai","ai-powered","borck-edu","career","career-development","career-guidance","desktop-app","edtech","electron","javascript","local-processing","privacy","privacy-first","resume","resume-analysis","tool","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/michael-borck.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-06-25T15:10:09.000Z","updated_at":"2026-05-21T02:09:05.000Z","dependencies_parsed_at":"2025-06-26T04:32:08.108Z","dependency_job_id":"a89b175f-b6e7-498b-bb2a-2dcb5d41ca81","html_url":"https://github.com/michael-borck/career-compass","commit_stats":null,"previous_names":["michael-borck/career-compass","michaelborck-education/career-compass"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/michael-borck/career-compass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-borck%2Fcareer-compass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-borck%2Fcareer-compass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-borck%2Fcareer-compass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-borck%2Fcareer-compass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michael-borck","download_url":"https://codeload.github.com/michael-borck/career-compass/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michael-borck%2Fcareer-compass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33392816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","ai-powered","borck-edu","career","career-development","career-guidance","desktop-app","edtech","electron","javascript","local-processing","privacy","privacy-first","resume","resume-analysis","tool","typescript"],"created_at":"2026-04-04T01:33:13.015Z","updated_at":"2026-05-23T11:05:44.441Z","avatar_url":"https://github.com/michael-borck.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- BADGES:START --\u003e\n[![edtech](https://img.shields.io/badge/-edtech-4caf50?style=flat-square)](https://github.com/topics/edtech) [![ai-powered](https://img.shields.io/badge/-ai--powered-blue?style=flat-square)](https://github.com/topics/ai-powered) [![career-development](https://img.shields.io/badge/-career--development-blue?style=flat-square)](https://github.com/topics/career-development) [![career-guidance](https://img.shields.io/badge/-career--guidance-blue?style=flat-square)](https://github.com/topics/career-guidance) [![desktop-app](https://img.shields.io/badge/-desktop--app-blue?style=flat-square)](https://github.com/topics/desktop-app) [![javascript](https://img.shields.io/badge/-javascript-f7df1e?style=flat-square)](https://github.com/topics/javascript) [![local-processing](https://img.shields.io/badge/-local--processing-blue?style=flat-square)](https://github.com/topics/local-processing) [![privacy-first](https://img.shields.io/badge/-privacy--first-blue?style=flat-square)](https://github.com/topics/privacy-first) [![resume-analysis](https://img.shields.io/badge/-resume--analysis-blue?style=flat-square)](https://github.com/topics/resume-analysis) [![tool](https://img.shields.io/badge/-tool-607d8b?style=flat-square)](https://github.com/topics/tool)\n\u003c!-- BADGES:END --\u003e\n\n\u003ca href=\"https://github.com/michael-borck/career-compass\"\u003e\n  \u003ch1 align=\"center\"\u003e🧭 Career Compass\u003c/h1\u003e\n\u003c/a\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003ePrivacy-first career exploration powered by AI\u003c/strong\u003e\u003cbr\u003e\n  Your data stays on your device. Your future stays in your hands.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/michael-borck/career-compass/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/michael-borck/career-compass?style=for-the-badge\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/michael-borck/career-compass/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/michael-borck/career-compass/release.yml?style=for-the-badge\" alt=\"Build Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/michael-borck/career-compass/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/michael-borck/career-compass?style=for-the-badge\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-features\"\u003e\u003cstrong\u003eFeatures\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"#-download\"\u003e\u003cstrong\u003eDownload\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"#-quick-start\"\u003e\u003cstrong\u003eQuick Start\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"#️-development\"\u003e\u003cstrong\u003eDevelopment\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🌟 What is Career Compass?\n\nCareer Compass is a **privacy-first desktop application** that helps you explore career paths based on your skills, interests, and experience. Unlike online career tools, **all processing happens locally on your device** - your resume and personal data never leave your computer.\n\n### 🔒 Privacy-First Philosophy\n\n- **Local Processing**: All file analysis happens on your device\n- **No Data Collection**: We don't collect, store, or transmit your personal information\n- **Secure Storage**: API keys are encrypted and stored locally using OS-native secure storage\n- **No Tracking**: Zero analytics, cookies, or external tracking\n\n## ✨ Features\n\n### 🤖 Multiple AI Providers\nChoose from multiple AI providers or run models locally:\n- **OpenAI** (GPT models)\n- **Anthropic Claude** \n- **Google Gemini**\n- **Groq** (fast inference)\n- **Ollama** (fully local, privacy-first)\n\n### 📄 File Upload Support\nUpload your resume in multiple formats:\n- **PDF** documents\n- **Microsoft Word** (.docx)\n- **Markdown** files\n\n### 🔧 Configurable Settings\n- Environment variable support for API keys\n- Persistent settings across app restarts\n- Connection testing for all providers\n- Model management (especially for Ollama)\n\n### 🎯 Career Exploration\n- Personalized career recommendations\n- Skills analysis and mapping\n- Interactive career path visualization\n- Based on your actual experience and interests\n\n## 📥 Download\n\nDownload the latest version for your operating system:\n\n### [📦 Latest Release](https://github.com/michael-borck/career-compass/releases/latest)\n\n| Platform | Download | Notes |\n|----------|----------|-------|\n| **Windows** | `Career-Compass-Setup-{version}.exe` | NSIS installer for Windows 10+ |\n| **macOS** | `Career-Compass-{version}-{arch}.dmg` | Universal build (Intel \u0026 Apple Silicon) |\n| **Linux** | `Career-Compass-{version}-x64.AppImage` | Portable application |\n\n### System Requirements\n\n- **Windows**: Windows 10 or later\n- **macOS**: macOS 10.14 or later\n- **Linux**: Most modern distributions (Ubuntu 18.04+, etc.)\n\n## 🚀 Quick Start\n\n1. **Download** the appropriate installer for your platform\n2. **Install** the application:\n   - **Windows**: Run the `.exe` installer\n   - **macOS**: Open the `.dmg` and drag to Applications\n   - **Linux**: Make the `.AppImage` executable and run it\n3. **Configure** your AI provider in Settings\n4. **Upload** your resume and start exploring!\n\n### First-Time Setup\n\n1. Open Career Compass\n2. Go to **Settings** → **AI Provider Configuration**\n3. Choose your preferred AI provider:\n   - For **privacy**: Use Ollama (local, no API key needed)\n   - For **convenience**: Use OpenAI, Claude, or others (API key required)\n4. Test your connection\n5. Return to the main page and upload your resume\n\n## 🛠️ Development\n\n### Prerequisites\n\n- **Node.js** 18+ \n- **npm** or **yarn**\n- **Git**\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/michael-borck/career-compass.git\ncd career-compass\n\n# Install dependencies\nnpm install\n\n# Start the development server\nnpm run dev\n\n# In another terminal, start Electron\nnpm run electron:dev\n```\n\n### Build for Production\n\n```bash\n# Build the renderer (Vite)\nnpm run build\n\n# Package for current platform\nnpm run electron:pack\n\n# Build distributables for all platforms\nnpm run electron:dist\n```\n\n### Checks \u0026 Releasing\n\n```bash\n# Type-check and run the test suite (also gated in CI on every PR)\nnpm run typecheck\nnpm test\n\n# Cut a release: bumps the version, tags it, and pushes — the tag triggers\n# the multi-platform build. See RELEASE.md for details.\nnpm run release\n```\n\n### Tech Stack\n\n- **Frontend**: Next.js 14 with TypeScript\n- **Desktop**: Electron with secure IPC\n- **Styling**: Tailwind CSS\n- **Visualization**: React Flow\n- **File Processing**: PDF-parse, Mammoth (DOCX)\n- **AI Integration**: OpenAI SDK (compatible with multiple providers)\n- **Storage**: electron-store with OS-native secure storage\n\n## 📋 Roadmap\n\n### Current Focus\n- [x] Multi-provider AI support\n- [x] Local file processing\n- [x] Secure settings persistence\n- [x] Cross-platform releases\n\n### Future Enhancements\n- [ ] Enhanced file format support (image OCR)\n- [ ] Multi-language support\n- [ ] Advanced career path visualization\n- [ ] Skills gap analysis\n- [ ] Resume improvement suggestions\n- [ ] Export career plans (PDF, Word)\n- [ ] Dark mode theme\n- [ ] Plugin system for custom algorithms\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n### Development Guidelines\n- Follow the existing code style\n- Write tests for new features\n- Update documentation as needed\n- Ensure privacy-first principles are maintained\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\nCareer Compass is forked from and inspired by [ExploreCareers](https://github.com/Nutlope/explorecareers) by Hassan El Mghari and Youssef Hasboun. This version has been enhanced for:\n\n- **Privacy-first architecture** with local processing\n- **Desktop application** with secure storage\n- **Multiple AI providers** including local options\n- **Cross-platform distribution** with automated releases\n\n## 🔗 Links\n\n- **Homepage**: [github.com/michael-borck/career-compass](https://github.com/michael-borck/career-compass)\n- **Releases**: [Releases Page](https://github.com/michael-borck/career-compass/releases)\n- **Issues**: [Bug Reports \u0026 Feature Requests](https://github.com/michael-borck/career-compass/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/michael-borck/career-compass/discussions)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ for career explorers worldwide\u003cbr\u003e\n  \u003cstrong\u003eYour privacy. Your data. Your future.\u003c/strong\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael-borck%2Fcareer-compass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichael-borck%2Fcareer-compass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichael-borck%2Fcareer-compass/lists"}