docling-project/docling

implement retry strategy for remote calls

Closed

#2,465 opened on Oct 15, 2025

View on GitHubContributor guide
 (2 comments) (0 reactions) (1 assignee)Python (4,140 forks)batch import
enhancementgood first issue

Repository metrics

Stars
 (59,751 stars)
PR merge metrics
 (Avg merge 7d 5h) (93 merged PRs in 30d)

Description

Hi, when for example sending images for description to remote API, it would be beneficial to add a retry strategy in the underlying requests calls, i.e.:

import requests

from requests.adapters import HTTPAdapter, Retry

s = requests.Session()

retries = Retry(total=5,
                backoff_factor=0.1,
                status_forcelist=[ 500, 502, 503, 504 ])

s.mount('http://', HTTPAdapter(max_retries=retries))

s.get('http://httpstat.us/500')

This way we could solve various errors that might happen during these calls, such as:

"Requests to the ChatCompletions_Create Operation under Azure OpenAI API have exceeded token rate limit of your current AIServices S0 pricing tier. Please retry after 11 seconds.

Contributor guide

Research direction
Examine the file docling/utils/api image request.py and implement a retry strategy using requests.Session with HTTPAdapter and Retry, as shown in the issue description.
Tech stack
python
Domain
backendapi
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Pythonrequests library
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75