Overview
This package provides the arvados module, an API client for Arvados. It also includes higher-level functions to help you write Crunch scripts, and command-line tools to store and retrieve data in the Keep storage server.
Installation
Installing under your user account
This method lets you install the package without root access. However, other users on the same system will need to reconfigure their shell in order to be able to use it. Run the following to install the package in an environment at ~/arvclients:
python3 -m venv ~/arvclients ~/arvclients/bin/pip install arvados-python-client
Command line tools will be installed under ~/arvclients/bin. You can test one by running:
~/arvclients/bin/arv-get --version
You can run these tools by specifying the full path every time, or you can add the directory to your shell’s search path by running:
export PATH="$PATH:$HOME/arvclients/bin"
You can make this search path change permanent by adding this command to your shell’s configuration, for example ~/.bashrc if you’re using bash. You can test the change by running:
arv-get --version
Installing on Debian and Ubuntu systems
Arvados publishes packages for Debian 12 “bookworm,” Ubuntu 22.04 “jammy,” and Ubuntu 24.04 “noble.” You can install the Python SDK package on any of these distributions by running the following commands:
sudo install -d /etc/apt/keyrings sudo curl -fsSL -o /etc/apt/keyrings/arvados.asc https://apt.arvados.org/pubkey.gpg sudo tee /etc/apt/sources.list.d/arvados.sources >/dev/null <<EOF Types: deb URIs: https://apt.arvados.org/$(lsb_release -cs) Suites: $(lsb_release -cs) Components: main Signed-by: /etc/apt/keyrings/arvados.asc EOF sudo apt update sudo apt install python3-arvados-python-client
Installing on Red Hat, AlmaLinux, and Rocky Linux
Arvados publishes packages for RHEL 8 and 9, as well as distributions based on those. Note that these packages depend on, and will automatically enable, the Python 3.11 module. You can install the Python SDK package on any of these distributions by running the following commands:
sudo tee /etc/yum.repos.d/arvados.repo >/dev/null <<'EOF' [arvados] name=Arvados baseurl=https://rpm.arvados.org/RHEL/$releasever/os/$basearch/ gpgcheck=1 gpgkey=https://rpm.arvados.org/RHEL/$releasever/RPM-GPG-KEY-arvados EOF sudo dnf install python3-arvados-python-client
Configuration
This client software needs two pieces of information to connect to Arvados: the DNS name of the API server, and an API authorization token. The Arvados user documentation describes how to find this information in the Arvados Workbench, and install it on your system.
Testing and Development
This package is one part of the Arvados source package, and it has integration tests to check interoperability with other Arvados components. Our hacking guide describes how to set up a development environment and run tests.
Release files for arvados-python-client 3.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| arvados_python_client-3.2.1.tar.gz | 232.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| arvados_python_client-3.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 405.3 kB
Release files / arvados_python_client-3.2.1.tar.gz
| Download URL | arvados_python_client-3.2.1.tar.gz |
|---|---|
| Size | 232.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b8a210cd04c177eb157e579c26c0cf0993d0a82fd85ad7bebe20b1fe10859c8
|
|
BLAKE2b-256 checksum How to use checksums |
d9df81ee570d3d8f073642883f4d142de00c4c4f42020da4b85dcaff4d2c9088
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|
Release files / arvados_python_client-3.2.1-py3-none-any.whl
| Download URL | arvados_python_client-3.2.1-py3-none-any.whl |
|---|---|
| Size | 173.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e3583457a9effb2b10ab1cdad56883986b7a1431979d6f6978d1d553790c8ced
|
|
BLAKE2b-256 checksum How to use checksums |
a109f7ccad973e3049ef6b466354624d487d1a9c0c4aeaa3a894c0bcf6bbbfa5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.19
|