Intelligent job aggregation and publishing platform powering ZenYukti Jobs on Discord.
Docs • Contributing • License
careers-engine is an open source backend that continuously discovers software engineering opportunities, normalizes and enriches the collected data, and publishes newly discovered opportunities through automated workflows.
The project eliminates manual tracking of company career pages by providing a reproducible pipeline for job discovery, storage, and publishing. It currently powers ZenYukti Jobs, while remaining modular enough to support additional sources, publishers, and deployment environments.
Interactive architecture diagram:
https://excalidraw.com/#json=foywzC6vYJtpt6wl_DKTE,T7vPnfxrNQHoC7OuYd6eAA
For a detailed explanation of the system architecture and individual components, see the project documentation.
- Automated job discovery from supported career sources
- Intelligent normalization and metadata enrichment
- Employment type inference
- Company branding with logos and accent colors
- Duplicate detection and publish history
- Automated Discord publishing
- GitHub Actions based automation
- Extensible source, parser, and publisher architecture
- Comprehensive testing and static analysis
The platform currently tracks software engineering opportunities from leading technology companies, including:
Google • Microsoft • Amazon • Apple • Meta
NVIDIA • OpenAI • Anthropic • Stripe • Databricks
Cloudflare • GitHub • Atlassian • Adobe • Salesforce
Uber • Airbnb • Flipkart • Razorpay • Zoho
…and many more.
| Component | Technology |
|---|---|
| Language | Python 3.12 |
| Package Management | uv |
| CI/CD | GitHub Actions |
| Storage | JSON |
| Publisher | Discord API |
| Assets | Simple Icons |
| Testing | pytest |
| Linting | Ruff |
| Type Checking | mypy |
- Python 3.12 or newer
- uv
- Git
Clone the repository.
git clone https://github.com/ZenYukti/careers-engine.git
cd careers-engineInstall project dependencies.
uv syncSee the project documentation to get started.
Project documentation is available at https://careers-engine.zenyukti.in.
The documentation is maintained under the docs/ directory and is powered by Mintlify.
.
├── assets/ Static assets
├── docs/ Project documentation
├── scripts/ CLI utilities and automation
├── src/
│ └── careers_engine/ Core application
├── tests/ Test suite
├── .github/workflows/ CI and scheduled workflows
├── pyproject.toml
└── README.md
Contributions, bug reports, and feature requests are welcome.
Please read CONTRIBUTING.md before opening a pull request.
This project is licensed under the MIT License. See the LICENSE file for details.
