grequests

What it is and what it does

GRequests is a thin wrapper around the requests library that uses gevent's greenlets to enable concurrent HTTP requests without explicit async syntax. Instead of writing async functions or managing thread pools, you create a generator of request objects and pass them to grequests.map(), which executes them concurrently using gevent's event loop. This approach is simpler than threading for I/O-bound work and predates Python's native async/await.

The package is useful when you need to make many HTTP calls in parallel but prefer gevent's greenlet model over asyncio or threading. However, maintenance is dormant: the last release was 2023-06-08 and there have been no updates since. This means no active bug fixes, security patches, or compatibility work with newer Python or dependency versions. For new projects, modern alternatives like httpx with asyncio or aiohttp may be more actively maintained.

Use it for:

• Fetch data from multiple URLs in parallel without writing async code, such as scraping or aggregating API responses.
• Batch process HTTP requests where greenlet-based concurrency is already part of your application stack.
• Migrate legacy code from synchronous requests to concurrent requests with minimal refactoring.
• Test or prototype concurrent HTTP behavior quickly without setting up asyncio event loops.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

GRequests wraps the requests library with gevent to make concurrent HTTP requests without explicit async/await syntax, allowing you to send many requests in parallel using lightweight greenlets.

Yes, if you are already using gevent in your project and need simple concurrent HTTP requests without async/await complexity. No, if you are starting a new project—use httpx with asyncio or aiohttp instead, as they are actively maintained and align with modern Python concurrency patterns. The dormant maintenance status means no security updates or compatibility fixes going forward.

Install

grequests on PyPI

pip install grequests

uv add grequests

poetry add grequests

Installing grequests

Before you install

Low friction: pure Python wheel with only two runtime dependencies (gevent and requests). Maintenance is dormant—last release was 2023-06-08 and last commit 2024-08-08, over 1163 days ago—so expect no active bug fixes or feature updates, though the repository remains public and unarchived.

License in practice

BSD license is permissive, allowing commercial and private use with minimal restrictions; you may use and modify grequests freely as long as you include the license notice.

Quickstart

import grequests

urls = ['http://example.com', 'http://example.org']
rs = (grequests.get(u) for u in urls)
responses = grequests.map(rs)
print(responses)

Requires gevent to be installed and functional; gevent uses greenlets which may have platform-specific behavior or require a C compiler for some installations.

Verify before relying

• Whether gevent's greenlet model is suitable for your concurrency needs compared to modern async/await patterns.
• Current compatibility with recent Python versions beyond 3.x, given dormant maintenance status.

Package facts

Evidence: grequests-0.7.0-py2.py3-none-any.whl

Tags

More Python Modules packages