🎉 AutoPR: Let's Automate Your Academic Promotion!

| [📝 ArXiv] | [📚 Project Website] | [🤗 PRBench] | [🔥 PRAgent Demo] |

This is the official implementation for "AUTOPR: LET'S AUTOMATE YOUR ACADEMIC PROMOTION!".

👀 1. Overview

As the volume of peer-reviewed research surges, scholars increasingly rely on social platforms for discovery, while authors invest significant effort in promotion to sustain visibility and citations. This project aims to address that challenge.

We formalize AutoPR (Automatic Promotion), a new task to automatically translate research papers into faithful, engaging, and well-timed public-facing content. To accomplish this, we developed PRAgent, a modular agentic framework for automatically transforming research papers into promotional posts optimized for specific social media platforms.

---

🔥 2. News

• [2025-10-08] Our 🔥🔥 PRAgent 🔥🔥 and 🔥🔥 PRBench 🔥🔥 benchmark is released! You can download the dataset from here.

---

🏅 3. Leaderboard

3.1 PRBench-Core

3.2 PRBench-Full

---

🛠️ 4. Installation & Configuration

4.1 Environment Installation

1. Create and activate a Conda environment (recommended):

   conda create -n autopr python=3.11
   conda activate autopr
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

4.2 Configuration

Before running the code, you need to configure your Large Language Model (LLM) API keys and endpoints.

First, copy the example .env.example file to a new .env file:

cp .env.example .env

Then, edit the .env file with your API credentials:

# Main API Base URL for text and vision models (e.g., OpenAI, Qwen, etc.)
OPENAI_API_BASE="https://api.openai.com/v1"
# Your API Key
OPENAI_API_KEY="sk-..."

The scripts will automatically load these environment variables.

---

⚡ 5. PRBench Evaluation

The entire workflow, from generation to evaluation, is managed through simple shell scripts.

5.1 Step 1: Preparation

Download the PRBench dataset from Hugging Face Hub. You can choose to download the full dataset or the core subset.

python download_and_reconstruct_prbench.py \
    --repo-id yzweak/PRBench \
    --subset core \ # or "full"
    --output-dir eval

You also need to download the DocLayout-YOLO model. You can specify the path to the model using the --model-path argument in the generation script.

5.2 Step 2: Evaluate Post Quality

After generation, use the evaluation script to assess the quality of the posts in your output directory.

chmod +x scripts/run_eval.sh
./scripts/run_eval.sh

5.3 Step 3: Calculate and View Metrics

Finally, run the calculation script to aggregate the raw evaluation data into a formatted results table.

chmod +x scripts/calc_results.sh
./scripts/calc_results.sh

🕹️ 6. PRAgent Generation

6.1 Step 1: Preparation

You need to download the DocLayout-YOLO model. When running the generation script, you can specify the path to the model using the --model-path argument.

for example:

python3 pragent/run.py --model-path /path/to/your/model.pt ...

6.2 Step 2: Generate Promotional Posts (PRAgent)

First, prepare your input directory. The script automatically determines the target platform based on the folder name:

• Numeric folder name -> Twitter (English)
• Alphanumeric folder name -> Xiaohongshu (Chinese)

/path/to/your/papers/
├── 12345/               # Numeric -> will generate a Twitter-style post in English
│   └── paper.pdf
└── some_paper_name/     # Alphanumeric -> will generate a Xiaohongshu-style post in Chinese
    └── paper.pdf

If you have run download_and_reconstruct.py, you can use the papers folder as input

Next, configure and run the generation script.

chmod +x scripts/run_pragent.sh
./script/run_generation.sh

PRAgent Case

Baseline:

PRAgent:

☎️ Contact

If interested in our work, please contact us at:

• Qiguang Chen: charleschen2333@gmail.com
• Zheng Yan: zyan@ir.hit.edu.cn

🎁 Citation

@misc{chen2025autopr,
      title={AutoPR: Let's Automate Your Academic Promotion!}, 
      author={Qiguang Chen and Zheng Yan and Mingda Yang and Libo Qin and Yixin Yuan and Hanjing Li and Jinhao Liu and Yiyan Ji and Dengyun Peng and Jiannan Guan and Mengkang Hu and Yantao Du and Wanxiang Che},
      journal={arXiv preprint arXiv:2510.09558},
      year={2025},
}