taco

Read and write TACO datasets in Python.

pip install taco-eo
python examples/minimal.py

Published wheels include the native TACO reader. Building from the source distribution requires a C++23 compiler, CMake, Ninja, pkg-config, libcurl 7.83 or newer, and OpenSSL 3 or newer.

import taco

samples = taco.read("dataset.zip")
parts = taco.read(["part-0.zip", "part-1.zip"])

dataset = taco.open_dataset("dataset.zip")
targets = dataset.read(files="target.tif")
train = dataset.sql("SELECT * FROM data WHERE \"ml:split\" = 'train'")

Versioned dataset roots select their declared default release without listing remote storage. Use a release URL to open an immutable version directly.

dataset = taco.open_dataset("https://data.source.coop/major-tom/core-dem/")
print(dataset.version)
print(dataset.versions)

previous = taco.open_dataset("https://data.source.coop/major-tom/core-dem/1.0.0/")

export() writes a smaller dataset with the same contract. samples is a PyArrow-compatible table, normally selected from the data SQL relation. Keyword arguments replace fields of the collection, such as id or description; the rest is inherited. For a remote source, metadata is cached and only the payload files belonging to the selected samples are downloaded. Pass overwrite=True to replace an existing TACO output.

source = "https://data.source.coop/major-tom/core-dem/"
dataset = taco.open_dataset(source)
rows = dataset.sql("SELECT * FROM data ORDER BY sample_id LIMIT 10")
taco.export(
    source,
    "core-dem-sample.zip",
    samples=rows,
    id="core-dem-sample",
    description="Ten samples from Core-DEM",
)

Remote reads and exports show download progress in interactive terminals. Writers show their build progress when opened with progress=True.

Examples

Every example is self-contained, uses synthetic data, and writes its output in the current directory.

Spatial and temporal metadata use separate profiles: Spatial for regular spatial grids, ISpatial for irregular footprints, and Temporal for time alone. STAC combines regular spatial + temporal metadata; ISTAC combines irregular spatial + temporal metadata.

Example What it demonstrates
minimal.py Smallest possible single-file dataset
numpy_minimal.py NumPy image and mask assets with a train/test split
change_detection.py Metadata on before/ and after/ folders
sequence.py Variable-length asset sequences
time_series.py Per-observation time and cloud metadata
geospatial.py Compact STAC metadata and derived MajorTOM cells
stac_segmentation.py STAC extensions for regular raster chips, labels, bands, and scaling
oceantaco_istac.py OceanTACO-inspired ISTAC metadata for irregular SWOT swaths and Argo collocations
partitioned.py ZIP partitions and their TACOCAT catalog

Project links

Data verified by PyPI on Sep 16, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for csaybar from gravatar.com csaybar

Credits

Author: Cesar Aybar

GitHub Statistics

Data verified by PyPI on Sep 16, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

antimeridian dev geoenrich rumi test test-eo

Tags

cloud-optimized cozip earth-observation geospatial machine-learning parquet taco

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

taco_eo-0.8.0.tar.gz (775.5 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

taco_eo-0.8.0-py3-none-win_amd64.whl (2.9 MB view details)

Uploaded Python 3Windows x86-64

taco_eo-0.8.0-py3-none-manylinux_2_28_x86_64.whl (4.9 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

taco_eo-0.8.0-py3-none-manylinux_2_28_aarch64.whl (5.0 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

taco_eo-0.8.0-py3-none-macosx_11_0_x86_64.whl (3.9 MB view details)

Uploaded Python 3macOS 11.0+ x86-64

taco_eo-0.8.0-py3-none-macosx_11_0_arm64.whl (4.0 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file taco_eo-0.8.0.tar.gz.

File metadata

  • Download URL: taco_eo-0.8.0.tar.gz
  • Upload date:
  • Size: 775.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for taco_eo-0.8.0.tar.gz
Algorithm Hash digest
SHA256 08abbc858129455641647a211363c9c817e820d767db8531b3d26a72e0316166
MD5 098e9975e170085f5a5c4865a8b0252f
BLAKE2b-256 88ec0068374121d20bac6334849880835f6924891a037a7b194801eb69788abb

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0.tar.gz:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file taco_eo-0.8.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: taco_eo-0.8.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for taco_eo-0.8.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 7d9547e9dc168d9d26c87fe844252b049cfe7135c92c76c24afdbae1d1352ad1
MD5 e3a4c39f1139032fb245a17230fa6e5a
BLAKE2b-256 abc8ea11e94362d0cb48fa86835a99564c5a1736fcd2c888675d6dd316b8188b

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0-py3-none-win_amd64.whl:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file taco_eo-0.8.0-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for taco_eo-0.8.0-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 0610c7cdc581b6e88111e3d1846e5c9299db6d773994f286815aaddd2768ad6f
MD5 b7fc7945e31eb93e9bba53a53a1d93be
BLAKE2b-256 a6cb178bccf448a06873ce28d34fd991e1f8ee02fdd37c77b8838a6f303b6988

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0-py3-none-manylinux_2_28_x86_64.whl:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file taco_eo-0.8.0-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for taco_eo-0.8.0-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 bbcf9da6cd03a5693f1ceb8eda2636a1b47c277f02f612393f1993ee52e11c8e
MD5 e38c631b615a17e0c37a0dc56c300077
BLAKE2b-256 a61985c83de08bdc3a246162e993fff8b4f1c556c8a6e19aee51b97499907be9

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0-py3-none-manylinux_2_28_aarch64.whl:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file taco_eo-0.8.0-py3-none-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for taco_eo-0.8.0-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 d8aa66da0bbc7ac7c6b6720c4101209309537c53d3838842484657f45fa92f51
MD5 8123bc25a05bc7f5d9335fa87d5e88c4
BLAKE2b-256 43eaf092e850e4efab593eea01700a5f59caccd2f58a15e7ba3283714a7976f0

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0-py3-none-macosx_11_0_x86_64.whl:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file taco_eo-0.8.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for taco_eo-0.8.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0209f23a48809fe3d11bec43ebe2fd32988328e30cf07f7be5125cd36fec3f9c
MD5 acca4ba71dd6db82909e816a10e544bd
BLAKE2b-256 925ac81947a58204b6cc44eb7fd9c74087d524c378ad2aaac92ffb8143a90e19

See more details on using hashes here.

Provenance

The following attestation bundles were made for taco_eo-0.8.0-py3-none-macosx_11_0_arm64.whl:

Publisher: release.yml on asterisk-labs/taco

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.8.0 This release

6 files

0.7.0

6 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

2 files

0.3.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page