Aioarxiv
An async Python client for the arXiv API with enhanced performance and flexible configuration options.
[!WARNING] This project is currently under development and has not yet reached a stable release. We do not recommend using it in production environments.
Features
- Asynchronous API calls for better performance
- Customized configuration client
- Flexible search and download capabilities
- Rate limiting and concurrency control aligned with the arXiv API terms of use
- Complete type hints (PEP 561) and documentation
Installation
pip install aioarxiv
Or with uv:
uv add aioarxiv
Quick Start
import asyncio
from aioarxiv import ArxivClient
async def main() -> None:
async with ArxivClient() as client:
result = await client.search("all:electron", max_results=10)
print(f"Total results: {result.total_result}")
for paper in result.papers:
print(paper.info.title)
asyncio.run(main())
Configuration
You can configure the client by passing an instance of ArxivConfig to the ArxivClient constructor.
Configuration in a dotenv file is also an option; values are loaded automatically from environment
variables with the ARXIV_ prefix.
from aioarxiv import ArxivClient, ArxivConfig
config = ArxivConfig(
proxy="http://127.0.0.1:10808",
log_level="DEBUG",
page_size=10,
)
client = ArxivClient(config=config)
Requirements
- Python 3.10 or higher
License
MIT License (c) 2025 BalconyJH
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aioarxiv-0.2.2.tar.gz.
File metadata
- Download URL: aioarxiv-0.2.2.tar.gz
- Upload date:
- Size: 198.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51073f3bee13c5838ad8e270c372f9ea621a75d24f9332a5af67ee6fa4693177
|
|
| MD5 |
615b60893054e3d4b70751efc66cdac7
|
|
| BLAKE2b-256 |
6a4be020940f845ec69b52557368d858e7db2d12f6c6f799678fda5db14c2ef6
|
Provenance
The following attestation bundles were made for aioarxiv-0.2.2.tar.gz:
Publisher:
publish.yml on BalconyJH/aioarxiv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aioarxiv-0.2.2.tar.gz -
Subject digest:
51073f3bee13c5838ad8e270c372f9ea621a75d24f9332a5af67ee6fa4693177 - Sigstore transparency entry: 2299667644
- Sigstore integration time:
-
Permalink:
BalconyJH/aioarxiv@123fba4a45ad64caf10d559b895d93a5e7808c48 -
Branch / Tag:
refs/tags/v0.2.2 - Owner: https://github.com/BalconyJH
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@123fba4a45ad64caf10d559b895d93a5e7808c48 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file aioarxiv-0.2.2-py3-none-any.whl.
File metadata
- Download URL: aioarxiv-0.2.2-py3-none-any.whl
- Upload date:
- Size: 28.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
63d70329c3bdd3a03a637997763a549db30adcccd85a6bf46cc6311a53776f94
|
|
| MD5 |
d1ac090179da04bef6b48891923e89c3
|
|
| BLAKE2b-256 |
d961c75ce4c87863913ed8560f62155c8275852906ffd441d5f0d1a3d45413a4
|
Provenance
The following attestation bundles were made for aioarxiv-0.2.2-py3-none-any.whl:
Publisher:
publish.yml on BalconyJH/aioarxiv
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
aioarxiv-0.2.2-py3-none-any.whl -
Subject digest:
63d70329c3bdd3a03a637997763a549db30adcccd85a6bf46cc6311a53776f94 - Sigstore transparency entry: 2299667699
- Sigstore integration time:
-
Permalink:
BalconyJH/aioarxiv@123fba4a45ad64caf10d559b895d93a5e7808c48 -
Branch / Tag:
refs/tags/v0.2.2 - Owner: https://github.com/BalconyJH
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@123fba4a45ad64caf10d559b895d93a5e7808c48 -
Trigger Event:
workflow_dispatch
-
Statement type:
