Welcome to Paperoni! Paperoni is a tool for paper management.

Search

The Search interface allows searching through Paperoni's database of papers. It searches as you type (with a short debounce). Results are sorted so that the most recent publications appear on top.

  • Title: Search by paper title.
  • Author: Search by author. It is currently not possible to search for multiple authors. We will likely add this functionality in the future.
  • Institution: Search by author affiliation or institution.
  • Venue: Search by venue. Venue aliases are not always taken into account, so you may need to search for "Neural Information Processing Systems" instead of "NeurIPS" or vice versa.
  • Start/end date: Search for a paper that had any release between the start and end date. For example, an article with a preprint in 2022 and a publication in 2023 will appear both in 2022 and in 2023.
  • Peer-reviewed: Check this box to only show peer-reviewed publications.

Click-to-filter

In the search results, you can click on an author name, institution, venue, or year to instantly filter results by that value.

Edit button

If you have validation permissions, an edit icon (edit) appears next to each paper title. Clicking it opens the edit page for that paper in a new tab, where you can modify its title, authors, venues, and other fields.

Editing papers

The edit interface lets you change all data associated to a paper, including title, abstract, authors and affiliations, releases (venues and dates), topics, links, and flags. You can also create a new paper from scratch at /edit/new, or delete a paper.

From the search page, click the edit icon on a paper to open its edit page.

Exclusions

The Exclusions page lets you manage a list of excluded paper identifiers. Excluded identifiers (e.g. arxiv:1234.5678, doi:10.1234/...) will be filtered out during paper discovery. You can add exclusions individually or in bulk (one per line), and remove them as needed.

Focuses

The Focuses page lets administrators configure research focuses that drive paper discovery and scoring. There are two tabs:

  • Main: Core focuses that define the research interests (authors, venues, topics, etc.) and their associated scores.
  • Auto: Automatically generated focuses. Use the "Autogenerate" button to regenerate them from the current collection.

Each focus has a type, name, score, and an optional flag that controls whether it drives discovery of new papers.

Workset

The Workset page shows papers in the current working set, scored and ranked by relevance to the configured focuses. Papers are displayed with their scores and metadata, and PDF links are available when fulltext has been located.

Latest group

The Latest Group page helps discover recently published papers. You can set an anchor date and a window (days back/forward) to find new papers. The anchor date is the center of the search window: Paperoni searches from anchor date - days back to anchor date + days forward (inclusive). For example, if the anchor date is 2026-02-19, with days back = 30 and days forward = 0, the interval is 2026-01-20 to 2026-02-19. If you set days forward = 7, the interval becomes 2026-01-20 to 2026-02-26. Results are split into peer-reviewed publications and preprints. A newsletter can be generated from these results.

Capabilities

The Capabilities page lets administrators manage user accounts and their permissions. You can add users, and grant or revoke capabilities such as search, validate, admin, and others. Implicit capabilities (derived from the capability hierarchy) are shown visually alongside directly assigned ones.

Reports

The Reports page lists available error reports generated from processing logs. Each report shows errors grouped by type, with tracebacks and occurrence counts. This is primarily useful for developers and administrators debugging data processing issues.

API token

To call the Paperoni API (e.g. search, export), you need a bearer token.

  1. Get a token: Navigate to Token. Sign in with Google when prompted. When the flow finishes, the page will show your token — copy it and store it securely.

  2. Use the token: Send it in the Authorization header as Bearer YOUR_TOKEN.

Example — search (first 10 results):

curl -H 'Authorization: Bearer YOUR_TOKEN' \
  'https://paperoni.mila.quebec/api/v1/search?limit=10&offset=0'

Replace YOUR_TOKEN with the token you copied and adjust the base URL if you use a different Paperoni instance.

For full REST API reference (endpoints, parameters, schemas), see the API documentation.

Bienvenue sur Paperoni ! Paperoni est un outil de gestion d'articles.

Recherche

L'interface Recherche permet de chercher dans la base d'articles de Paperoni. La recherche se fait au fil de la frappe (avec un court délai). Les résultats sont triés pour afficher les publications les plus récentes en premier.

  • Titre : Recherche par titre d'article.
  • Auteur : Recherche par auteur. Il n'est pas encore possible de chercher plusieurs auteurs. Cette fonctionnalité sera probablement ajoutée à l'avenir.
  • Institution : Recherche par affiliation ou institution de l'auteur.
  • Conférence : Recherche par lieu de publication (conférence ou revue scientifique). Les alias ne sont pas toujours pris en compte ; vous devrez peut-être chercher « Neural Information Processing Systems » au lieu de « NeurIPS » ou l'inverse.
  • Date de début/fin : Recherche d'articles ayant au moins une parution entre ces dates. Par exemple, un article avec une prépublication en 2022 et une publication en 2023 apparaîtra pour 2022 et 2023.
  • Évalué par les pairs : Cochez cette case pour n'afficher que les publications évaluées par les pairs.

Filtrage par clic

Dans les résultats, vous pouvez cliquer sur un nom d'auteur, une institution, un lieu ou une année pour filtrer immédiatement les résultats par cette valeur.

Bouton Modifier

Si vous avez les droits de validation, une icône de modification (modifier) apparaît à côté de chaque titre. Un clic ouvre la page d'édition de l'article dans un nouvel onglet, où vous pouvez modifier le titre, les auteurs, les lieux et autres champs.

Modification des articles

L'interface d'édition permet de modifier toutes les données d'un article : titre, résumé, auteurs et affiliations, parutions (lieux et dates), sujets, liens et drapeaux. Vous pouvez aussi créer un nouvel article depuis /edit/new, ou supprimer un article.

Depuis la page de recherche, cliquez sur l'icône d'édition d'un article pour ouvrir sa page de modification.

Exclusions

La page Exclusions permet de gérer une liste d'identifiants d'articles exclus. Les identifiants exclus (ex. arxiv:1234.5678, doi:10.1234/...) sont filtrés lors de la découverte d'articles. Vous pouvez ajouter des exclusions une par une ou en lot (une par ligne), et les retirer au besoin.

Focus

La page Focus permet aux administrateurs de configurer les focus de recherche qui pilotent la découverte et le scoring des articles. Deux onglets :

  • Principal : Focus principaux qui définissent les centres d'intérêt (auteurs, lieux, sujets, etc.) et leurs scores associés.
  • Auto : Focus générés automatiquement. Utilisez le bouton « Autogénérer » pour les régénérer à partir de la collection actuelle.

Chaque focus a un type, un nom, un score et une option pour indiquer s'il pilote la découverte de nouveaux articles.

Jeu de travail

La page Jeu de travail affiche les articles du jeu de travail actuel, scorés et classés selon les focus configurés. Les articles sont affichés avec leurs scores et métadonnées ; les liens PDF sont disponibles lorsque le texte intégral a été localisé.

Groupe récent

La page Groupe récent permet de découvrir les articles récemment publiés. Vous pouvez définir une date d'ancrage et une fenêtre (jours en arrière/avant) pour trouver de nouveaux articles. La date d'ancrage est le centre de la fenêtre : Paperoni cherche entre date d'ancrage - jours en arrière et date d'ancrage + jours en avant (inclus). Par exemple, si la date d'ancrage est 2026-02-19, avec jours en arrière = 30 et jours en avant = 0, l'intervalle est 2026-01-20 à 2026-02-19. Avec jours en avant = 7, l'intervalle devient 2026-01-20 à 2026-02-26. Les résultats sont séparés en publications évaluées par les pairs et prépublications. Une newsletter peut être générée à partir de ces résultats.

Capacités

La page Capacités permet aux administrateurs de gérer les comptes utilisateurs et leurs permissions. Vous pouvez ajouter des utilisateurs et attribuer ou révoquer des capacités comme search, validate, admin, etc. Les capacités implicites (dérivées de la hiérarchie) sont affichées avec les capacités attribuées directement.

Rapports

La page Rapports liste les rapports d'erreur disponibles générés à partir des journaux de traitement. Chaque rapport affiche les erreurs groupées par type, avec tracebacks et nombre d'occurrences. Utile principalement aux développeurs et administrateurs pour le débogage du traitement des données.

Jeton API

Pour appeler l'API Paperoni (recherche, export, etc.), vous avez besoin d'un jeton (token) porteur.

  1. Obtenir un jeton : Ouvrez la page Jeton. Connectez-vous avec Google lorsque demandé. À la fin du processus, la page affichera votre jeton — copiez-le et conservez-le de manière sécurisée.

  2. Utiliser le jeton : Envoyez-le dans l'en-tête Authorization sous la forme Bearer VOTRE_JETON.

Exemple — recherche (10 premiers résultats) :

curl -H 'Authorization: Bearer VOTRE_JETON' \
  'https://paperoni.mila.quebec/api/v1/search?limit=10&offset=0'

Remplacez VOTRE_JETON par le jeton copié et adaptez l'URL de base si vous utilisez une autre instance Paperoni.

Pour la référence complète de l'API REST (endpoints, paramètres, schémas), consultez la documentation API.