datalad

library1.6.0pypypi✓ verified 85d ago

DataLad is a distributed system for joint management of code, data, and their relationships, built on top of Git and git-annex. Current version is 1.4.1, with frequent bug-fix releases. Requires Python >=3.10.

data devops workflow

pip install datalad

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · DATALAD

datalad

datapythonv1.6.0

Install

7.6s avg

Import

—

Disk

90MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 89.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 7.6s · import 0.000s · 91MB

90MB installed

● package 90MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

datalad

✓ import datalad

✗ from datalad import api

datalad.api is a legacy alias; prefer direct import of datalad.api.

datalad.api

✓ from datalad.api import Dataset

✗ import DataLad

Case-sensitive; module is lowercase 'datalad'.

Dataset

✓ from datalad.api import Dataset

✗ from datalad import Dataset

Dataset is in datalad.api, not top-level.

Install a dataset from a DataLad superdataset URL and print its ID.

from datalad.api import Dataset ds = Dataset('.') ds.install(source='///example/dataset') print(ds.id)

datalad --version

Debug

Known issues

breakingPython 3.9 support dropped in DataLad 1.3.0; requires Python >=3.10.

fix

Upgrade Python to 3.10 or later.

affects: >=1.3.0

breakingpatoolib API change in version 2.0 broke DataLad <1.4.1; DataLad 1.4.1 includes a fix.

fix

Upgrade to DataLad 1.4.1 or pin patoolib<2.0.

affects: 1.4.0

gotchaDataLad uses custom markers for pytest; extensions must register them or use the DataLad pytest plugin introduced in 1.4.0.

fix

In conftest.py, use pytest_plugins = ['datalad.tests.fixtures'] to auto-register.

affects: >=1.4.0

gotchaOperations on adjusted branches (crippled filesystems) may require extra merge steps; fixed in 1.3.3.

fix

Upgrade to 1.3.3+ or manually run git annex merge/adjust.

affects: <1.3.3

Errors

Common errors & fixes

ImportError: cannot import name 'Dataset' from 'datalad'

Dataset is not in datalad top-level; it's in datalad.api.

fix

Use 'from datalad.api import Dataset'

AttributeError: module 'datalad' has no attribute 'api'

Python 3.10+ may shadow with a local file named datalad.py.

fix

Rename any local script or module named 'datalad.py'.

CommandNotFoundError: git-annex is not installed

git-annex binary missing from PATH.

fix

Install git-annex via system package manager (e.g., apt-get install git-annex-standalone)

requests.exceptions.InvalidURL: Failed to parse: ///example/dataset

Triple-slash URLs are valid only with a configured remote; raw source URL needed.

fix

Use a valid git URL like 'https://github.com/datalad-datasets/longnow-podcasts.git'

Upgrade

Version history

1.6.0latest on PyPI · released Jun 9, 2026

Audit

Dependencies

git-annexrequiredRequired runtime dependency for annex operations

patooliboptionalUsed for archive extraction; API changed in 2.0

Agent activity

21 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/datalad/datalad ↗

packagehttps://pypi.org/project/datalad/ ↗

homepagehttps://www.datalad.org ↗

docshttps://handbook.datalad.org ↗