README.md

---
title: AI Deadlines
emoji: ⚡
colorFrom: gray
colorTo: blue
sdk: docker
pinned: false
app_port: 8080
---

# AI Conference Deadlines

A web app to quickly see submission deadlines to top AI conferences, such as NeurIPS and ICLR.

This helps researchers in quickly seeing when to submit their paper.

Note: papers can be submitted at any time to [hf.co/papers](https://hf.co/papers) at [hf.co/papers/submit](https://hf.co/papers/submit), assuming the paper is available on [Arxiv](https://arxiv.org/).

The benefit of [hf.co/papers](https://hf.co/papers) is that it allows people to quickly find related artifacts, such as models, datasets and demos. See [this paper page](https://huggingface.co/papers/2502.04328) as a nice example - it has 3 models, 1 dataset and 1 demo linked.

## Project info

This project is entirely based on the awesome https://github.com/paperswithcode/ai-deadlines. As that repository is no longer maintained, we decided to make an up-to-date version along with a new UI. It was bootstrapped using [Lovable](https://lovable.dev/) and [Cursor](https://www.cursor.com/).

New data is fetched from https://github.com/ccfddl/ccf-deadlines/tree/main/conference/AI thanks to [this comment](https://github.com/paperswithcode/ai-deadlines/issues/723#issuecomment-2603420945). 

A CRON job (set up as a [Github action](.github/workflows/update-conferences.yml)) automatically updates the conference data in individual YAML files located in src/data/conferences/.

**URL**: https://huggingface.co/spaces/huggingface/ai-deadlines

## Contribute

Contributions are very welcome!

To keep things minimal, we mainly focus on top-tier conferences in AI.

To add or update a deadline:
- Fork the repository
- Add a new block to the appropriate conference file in [src/data/conferences/](src/data/conferences/). Do not update an existing block of a previous time the conference took place but rather add a new block at the bottom of the file
- Make sure it has the `title`, `year`, `id`, `link`, `deadlines`, `timezone`, `date`, `city`, `country`, `tags` attributes
    + See available timezone strings [here](https://momentjs.com/timezone/).
- Optionally add a `venue`, `note` and `hindex` (this refers to the h5-index from [here](https://scholar.google.com/citations?view_op=top_venues&vq=eng)) which indicates the importance of a conference

You can add any custom number of deadlines, with any custom string for the `type` and `label`. The app will simply use the first upcoming deadline to showcase a deadline counter, and display all upcoming deadlines in the conference details card.

Example:
```yaml
- title: BestConf
  year: 2022
  id: bestconf22  # title as lower case + last two digits of year
  full_name: Best Conference for Anything  # full conference name
  link: link-to-website.com
  deadlines:
    - type: abstract
      label: Abstract deadline
      date: '2025-10-09 13:59:59'
      timezone: GMT+02
    - type: submission
      label: Paper submission deadline
      date: '2025-10-09 13:59:59'
      timezone: GMT+02
  timezone: Asia/Seoul
  city: Incheon
  country: South Korea
  venue: Incheon Conference Centre, South Korea
  date: September, 18-22, 2022
  start: YYYY-MM-DD
  end: YYYY-MM-DD
  paperslink: link-to-full-paper-list.com
  pwclink: link-to-papers-with-code.com
  hindex: 100.0
  tags:
  - machine learning
  note: Important
```
- Send a pull request to update the appropriate conference file in [src/data/conferences/](src/data/conferences/).

## How to run locally

If you want to work locally using your own IDE, you can clone this repo and push changes.

The only requirement is having Node.js & npm installed - [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating)

Follow these steps:

```sh
# Step 1: Clone the repository using the project's Git URL.
git clone https://github.com/huggingface/ai-deadlines

# Step 2: Navigate to the project directory.
cd ai-deadlines

# Step 3: Install the necessary dependencies.
npm i

# Step 4: Start the development server with auto-reloading and an instant preview.
npm run dev
```

This runs the app at http://localhost:8080/.

## Deploy with Docker

First build the Docker image as follows:

```bash
docker build -t ai-deadlines .
```

Next it can be run as follows:

```bash
docker run -it -p 8080:8080 ai-deadlines
```

You can see it in your web browser at http://localhost:8080/.

## Deploy on the cloud

One way to deploy this on a cloud is by using [Artifact Registry](https://cloud.google.com/artifact-registry/docs) (for hosting the Docker image) and [Cloud Run](https://cloud.google.com/run?hl=en) (a serverless service by Google to run Docker containers). See [this YouTube video](https://youtu.be/cw34KMPSt4k?si=UbzNRobNzib93uDl) for a nice intro.

Make sure to:
- create a [Google Cloud project](https://console.cloud.google.com/)
- set up a billing account
- have the [gcloud SDK installed](https://cloud.google.com/sdk/docs/install).

To deploy, simply run:

```bash
gcloud auth login
gcloud auth application-default login
gcloud run deploy --source .
```

## Technologies used

This project is built with:

- Vite
- TypeScript
- React
- shadcn-ui
- Tailwind CSS

## License

This project is licensed under [MIT](LICENSE).

## Maintainers

Feel free to just open an issue. Otherwise contact @nielsrogge