Gradio x MCP Hackathon Project -- France Chômage

📚 Overview

This repository contains the code for the Gradio x MCP Hackathon project named "France Chômage". The project consists of two tracks, each with its own application:

• Track 1 - A gradio MCP server providing AI agents with tools to search for and analyze job offers.
• Track 2 - A gradio multi-agents application using MCP tools to search for job offers that match a user's profile and search criteria.

📋 Pre-requisites

Before starting, ensure you have the following tools installed on your machine:

• Python 3.10-3.13 (Download)
• Git (Download)

ℹ️ Note: Other tools (pre-commit, ruff) will be installed automatically with the project dependencies.

🚀 Installation

1. Clone the repository

git clone https://github.com/AubinSeptier/gradio-mcp-hack.git
cd gradio-mcp-hack

2. Create a virtual environment

On Linux/macOS :

python -m venv .venv
source .venv/bin/activate

On Windows :

python -m venv .venv
.venv\Scripts\activate

ℹ️ Note: You can use conda or any other virtual environment manager if you prefer.

3. Install dependencies

Basic installation :

pip install -e .

Installation with development tools :

pip install -e ".[dev]"

4. Configure pre-commit

pre-commit install

Check that everything works by running all pre-commit hooks on all files:

pre-commit run --all-files

🛠️ Development

Project Structure

gradio-mcp-hack/
├── .github/
│   └── PULL_REQUEST_TEMPLATE.md
├── src/
│   └── france-chomage-mcp-server/
│       └── README.md
        └── app.py
│   └── agentic-france-chomage/
│       └── README.md
│       └── app.py
├── .gitignore
├── pyproject.toml
├── .pre-commit-config.yaml
└── README.md
└── LICENSE

🤝 Contribution

Please check the PULL_REQUEST_TEMPLATE.md file in the .github folder for guidelines on how to contribute to this project.