{"id":23511,"library":"datalad","title":"DataLad","description":"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.","status":"active","version":"1.4.1","language":"python","source_language":"en","source_url":"https://github.com/datalad/datalad","tags":["data management","git-annex","reproducible science","version control","distributed"],"install":[{"cmd":"pip install datalad","lang":"bash","label":"Install latest stable"}],"dependencies":[{"reason":"Required runtime dependency for annex operations","package":"git-annex","optional":false},{"reason":"Used for archive extraction; API changed in 2.0","package":"patoolib","optional":true}],"imports":[{"note":"datalad.api is a legacy alias; prefer direct import of datalad.api.","wrong":"from datalad import api","symbol":"datalad","correct":"import datalad"},{"note":"Case-sensitive; module is lowercase 'datalad'.","wrong":"import DataLad","symbol":"datalad.api","correct":"from datalad.api import Dataset"},{"note":"Dataset is in datalad.api, not top-level.","wrong":"from datalad import Dataset","symbol":"Dataset","correct":"from datalad.api import Dataset"}],"quickstart":{"code":"from datalad.api import Dataset\nds = Dataset('.')\nds.install(source='///example/dataset')\nprint(ds.id)","lang":"python","description":"Install a dataset from a DataLad superdataset URL and print its ID."},"warnings":[{"fix":"Upgrade Python to 3.10 or later.","message":"Python 3.9 support dropped in DataLad 1.3.0; requires Python >=3.10.","severity":"breaking","affected_versions":">=1.3.0"},{"fix":"Upgrade to DataLad 1.4.1 or pin patoolib<2.0.","message":"patoolib API change in version 2.0 broke DataLad <1.4.1; DataLad 1.4.1 includes a fix.","severity":"breaking","affected_versions":"1.4.0"},{"fix":"In conftest.py, use pytest_plugins = ['datalad.tests.fixtures'] to auto-register.","message":"DataLad uses custom markers for pytest; extensions must register them or use the DataLad pytest plugin introduced in 1.4.0.","severity":"gotcha","affected_versions":">=1.4.0"},{"fix":"Upgrade to 1.3.3+ or manually run git annex merge/adjust.","message":"Operations on adjusted branches (crippled filesystems) may require extra merge steps; fixed in 1.3.3.","severity":"gotcha","affected_versions":"<1.3.3"}],"env_vars":null,"search_vec":"'1.4.1':28 '3.10':37 'annex':24,42 'bug':32 'bug-fix':31 'built':16 'code':11 'control':46 'current':25 'data':12,38 'datalad':1,2 'distribut':5,47 'fix':33 'frequent':30 'git':20,23,41 'git-annex':22,40 'joint':8 'manag':9,39 'python':36 'relationship':15 'releas':34 'reproduc':43 'requir':35 'scienc':44 'system':6 'top':18 'version':26,45","created_at":"2026-05-01T08:08:10.289595+00:00","updated_at":"2026-05-01T08:08:10.289595+00:00","problems":[{"fix":"Use 'from datalad.api import Dataset'","cause":"Dataset is not in datalad top-level; it's in datalad.api.","error":"ImportError: cannot import name 'Dataset' from 'datalad'"},{"fix":"Rename any local script or module named 'datalad.py'.","cause":"Python 3.10+ may shadow with a local file named datalad.py.","error":"AttributeError: module 'datalad' has no attribute 'api'"},{"fix":"Install git-annex via system package manager (e.g., apt-get install git-annex-standalone)","cause":"git-annex binary missing from PATH.","error":"CommandNotFoundError: git-annex is not installed"},{"fix":"Use a valid git URL like 'https://github.com/datalad-datasets/longnow-podcasts.git'","cause":"Triple-slash URLs are valid only with a configured remote; raw source URL needed.","error":"requests.exceptions.InvalidURL: Failed to parse: ///example/dataset"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.6.0","cli_name":"datalad","cli_version":"Traceback (most recent call last):","type":"library","homepage":"https://www.datalad.org","github":"https://github.com/datalad/datalad","docs":"https://handbook.datalad.org","changelog":null,"pypi":"https://pypi.org/project/datalad/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","devops","workflow"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}