Skip to content

clementvidon/devbarometer

Repository files navigation

CI Coverage License: MIT TypeScript Last commit

DevBarometer

The dev job market barometer — powered by Reddit sentiment.

Table of Contents

  1. Overview
  2. Quick Start
  3. Automation
  4. Contributing
  5. License

Overview

DevBarometer is a daily snapshot of the French dev job market’s mood — powered by Reddit sentiment.

By analyzing fresh posts from r/developpeur, it reveals if the vibe is gold rush or hiring freeze.

Curious if it’s a good time to apply or complain? Let the devs tell you.

Quick Start

Requirements

  1. Clone the repository:
git clone https://github.com/clementvidon/devbarometer.git
cd devbarometer
  1. Install NodeJS: https://nodejs.org/en/download

NOTE: Ensure your Node version matches the one specified in the engines field of package.json.

  1. Get an OpenAI API key: https://platform.openai.com/

NOTE: Make sure your OpenAI account has billing enabled and some credit — a few dollars are enough for testing.

Run the app

Copy the .env.example file to .env in each subdirectory where it exists, and activate direnv.

  1. Set up environment variables:
cp .env.example .env

Then open .env and replace the placeholder with your actual API key:

OPENAI_API_KEY=sk-...
  1. Install dependencies:
npm install
  1. Run the project:
npm start

Automation

This runs daily via GitHub Actions and pushes public/index.html to GitHub Pages.


Contributing

We welcome contributions to improve the reliability and scalability of DevBarometer!

Focus Areas for Contribution

  • Data Quality and Sources Help expand beyond Reddit by integrating other relevant communities or platforms. The goal is to reduce sampling bias and improve the richness and diversity of the dataset.

  • Model Improvement Help refine emotion and relevance analysis by proposing or integrating better LLM models, for more precise and reliable sentiment detection.

  • Scalability Help extend DevBarometer beyond the developer market. The methodology can be adapted into a broader WorkBarometer (or other domain-specific barometers) to assess sentiment trends in different professions or industries.

We are especially looking for contributions that make DevBarometer more truthful, diverse, and extensible.

Please read the Contributing Guide before submitting a pull request.


License

MIT

This project is open source and freely available under the MIT License. You are free to use, modify, and distribute it with attribution.

About

The dev job market barometer powered by Reddit sentiment.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published