datachain 0.7.9__tar.gz → 0.7.10__tar.gz

{datachain-0.7.9 → datachain-0.7.10}/.github/workflows/tests.yml

@@ -3,7 +3,7 @@ name: Tests
 on:
   push:
     branches: [main]
-  pull_request:
+  pull_request_target:
   workflow_dispatch:
 
 env:
@@ -14,13 +14,22 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  authorize:
+    environment: ${{ github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name != github.repository && 'external' || 'internal' }}
+    runs-on: ubuntu-latest
+    steps:
+      - run: true
+
   lint:
+    needs: authorize
+
     runs-on: ubuntu-latest
     steps:
       - name: Check out the repository
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
       - name: Set up Python 3.9
         uses: actions/setup-python@v5
@@ -53,6 +62,8 @@ jobs:
         run: nox -s lint
 
   datachain:
+    needs: authorize
+
     timeout-minutes: 40
     runs-on: ${{ matrix.os }}
     strategy:
@@ -75,6 +86,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
       - name: Set up Python ${{ matrix.pyv }}
         uses: actions/setup-python@v5
@@ -117,6 +129,8 @@ jobs:
         run: nox -s docs
 
   examples:
+    needs: authorize
+
     runs-on: ${{ matrix.os }}
     timeout-minutes: 60
     strategy:
@@ -132,9 +146,10 @@ jobs:
           - {os: ubuntu-latest-4-cores, pyv: "3.9", group: multimodal}
           - {os: ubuntu-latest-4-cores, pyv: "3.12", group: multimodal}
 
-
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
       - name: Set up Python ${{ matrix.pyv }}
         uses: actions/setup-python@v5

datachain-0.7.10/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.1
+Name: datachain
+Version: 0.7.10
+Summary: Wrangle unstructured AI data at scale
+Author-email: Dmitry Petrov <support@dvc.org>
+License: Apache-2.0
+Project-URL: Documentation, https://datachain.dvc.ai
+Project-URL: Issues, https://github.com/iterative/datachain/issues
+Project-URL: Source, https://github.com/iterative/datachain
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Development Status :: 2 - Pre-Alpha
+Requires-Python: >=3.9
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: pyyaml
+Requires-Dist: tomlkit
+Requires-Dist: tqdm
+Requires-Dist: numpy<3,>=1
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pyarrow
+Requires-Dist: typing-extensions
+Requires-Dist: python-dateutil>=2
+Requires-Dist: attrs>=21.3.0
+Requires-Dist: s3fs>=2024.2.0
+Requires-Dist: gcsfs>=2024.2.0
+Requires-Dist: adlfs>=2024.2.0
+Requires-Dist: dvc-data<4,>=3.10
+Requires-Dist: dvc-objects<6,>=4
+Requires-Dist: shtab<2,>=1.3.4
+Requires-Dist: sqlalchemy>=2
+Requires-Dist: multiprocess==0.70.16
+Requires-Dist: cloudpickle
+Requires-Dist: orjson>=3.10.5
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: jmespath>=1.0
+Requires-Dist: datamodel-code-generator>=0.25
+Requires-Dist: Pillow<12,>=10.0.0
+Requires-Dist: msgpack<2,>=1.0.4
+Requires-Dist: psutil
+Requires-Dist: huggingface_hub
+Requires-Dist: iterative-telemetry>=0.0.9
+Requires-Dist: platformdirs
+Requires-Dist: dvc-studio-client<1,>=0.21
+Requires-Dist: tabulate
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.2; extra == "docs"
+Requires-Dist: mkdocs-gen-files>=0.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.3.1; extra == "docs"
+Requires-Dist: mkdocs-section-index>=0.3.6; extra == "docs"
+Requires-Dist: mkdocstrings-python>=1.6.3; extra == "docs"
+Requires-Dist: mkdocs-literate-nav>=0.6.1; extra == "docs"
+Provides-Extra: torch
+Requires-Dist: torch>=2.1.0; extra == "torch"
+Requires-Dist: torchvision; extra == "torch"
+Requires-Dist: transformers>=4.36.0; extra == "torch"
+Provides-Extra: remote
+Requires-Dist: lz4; extra == "remote"
+Requires-Dist: requests>=2.22.0; extra == "remote"
+Provides-Extra: vector
+Requires-Dist: usearch; extra == "vector"
+Provides-Extra: hf
+Requires-Dist: numba>=0.60.0; extra == "hf"
+Requires-Dist: datasets[audio,vision]>=2.21.0; extra == "hf"
+Provides-Extra: tests
+Requires-Dist: datachain[hf,remote,torch,vector]; extra == "tests"
+Requires-Dist: pytest<9,>=8; extra == "tests"
+Requires-Dist: pytest-sugar>=0.9.6; extra == "tests"
+Requires-Dist: pytest-cov>=4.1.0; extra == "tests"
+Requires-Dist: pytest-mock>=3.12.0; extra == "tests"
+Requires-Dist: pytest-servers[all]>=0.5.8; extra == "tests"
+Requires-Dist: pytest-benchmark[histogram]; extra == "tests"
+Requires-Dist: pytest-xdist>=3.3.1; extra == "tests"
+Requires-Dist: virtualenv; extra == "tests"
+Requires-Dist: dulwich; extra == "tests"
+Requires-Dist: hypothesis; extra == "tests"
+Requires-Dist: open_clip_torch; extra == "tests"
+Requires-Dist: aiotools>=1.7.0; extra == "tests"
+Requires-Dist: requests-mock; extra == "tests"
+Requires-Dist: scipy; extra == "tests"
+Provides-Extra: dev
+Requires-Dist: datachain[docs,tests]; extra == "dev"
+Requires-Dist: mypy==1.13.0; extra == "dev"
+Requires-Dist: types-python-dateutil; extra == "dev"
+Requires-Dist: types-pytz; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Requires-Dist: types-tabulate; extra == "dev"
+Provides-Extra: examples
+Requires-Dist: datachain[tests]; extra == "examples"
+Requires-Dist: numpy<2,>=1; extra == "examples"
+Requires-Dist: defusedxml; extra == "examples"
+Requires-Dist: accelerate; extra == "examples"
+Requires-Dist: unstructured[embed-huggingface,pdf]<0.16.0; extra == "examples"
+Requires-Dist: pdfplumber==0.11.4; extra == "examples"
+Requires-Dist: huggingface_hub[hf_transfer]; extra == "examples"
+Requires-Dist: onnx==1.16.1; extra == "examples"
+Requires-Dist: ultralytics==8.3.37; extra == "examples"
+
+================
+|logo| DataChain
+================
+
+|PyPI| |Python Version| |Codecov| |Tests|
+
+.. |logo| image:: docs/assets/datachain.svg
+   :height: 24
+.. |PyPI| image:: https://img.shields.io/pypi/v/datachain.svg
+   :target: https://pypi.org/project/datachain/
+   :alt: PyPI
+.. |Python Version| image:: https://img.shields.io/pypi/pyversions/datachain
+   :target: https://pypi.org/project/datachain
+   :alt: Python Version
+.. |Codecov| image:: https://codecov.io/gh/iterative/datachain/graph/badge.svg?token=byliXGGyGB
+   :target: https://codecov.io/gh/iterative/datachain
+   :alt: Codecov
+.. |Tests| image:: https://github.com/iterative/datachain/actions/workflows/tests.yml/badge.svg
+   :target: https://github.com/iterative/datachain/actions/workflows/tests.yml
+   :alt: Tests
+
+DataChain is a Python-based AI-data warehouse for transforming and analyzing unstructured
+data like images, audio, videos, text and PDFs. It integrates with external storage
+(e.g. S3) to process data efficiently without data duplication and manages metadata
+in an internal database for easy and efficient querying.
+
+
+Use Cases
+=========
+
+1. **ETL.** Pythonic framework for describing and running unstructured data transformations
+   and enrichments, applying models to data, including LLMs.
+2. **Analytics.** DataChain dataset is a table that combines all the information about data
+   objects in one place + it provides dataframe-like API and vecrorized engine to do analytics
+   on these tables at scale.
+3. **Versioning.** DataChain doesn't store, require moving or copying data (unlike DVC).
+   Perfect use case is a bucket with thousands or millions of images, videos, audio, PDFs.
+
+
+Key Features
+============
+
+📂 **Multimodal Dataset Versioning.**
+   - Version unstructured data without moving or creating data copies, by supporting
+     references to S3, GCP, Azure, and local file systems.
+   - Multimodal data support: images, video, text, PDFs, JSONs, CSVs, parquet, etc.
+   - Unite files and metadata together into persistent, versioned, columnar datasets.
+
+🐍 **Python-friendly.**
+   - Operate on Python objects and object fields: float scores, strings, matrixes,
+     LLM response objects.
+   - Run Python code in a high-scale, terabytes size datasets, with built-in
+     parallelization and memory-efficient computing — no SQL or Spark required.
+
+🧠 **Data Enrichment and Processing.**
+   - Generate metadata using local AI models and LLM APIs.
+   - Filter, join, and group datasets by metadata. Search by vector embeddings.
+   - High-performance vectorized operations on Python objects: sum, count, avg, etc.
+   - Pass datasets to Pytorch and Tensorflow, or export them back into storage.
+
+
+Getting Started
+===============
+
+Visit `Quick Start <https://docs.datachain.ai/quick-start>`_ to get started with `DataChain` and learn more.
+
+
+Contributing
+============
+
+Contributions are very welcome. To learn more, see the `Contributor Guide`_.
+
+
+Community and Support
+=====================
+
+* `Docs <https://docs.datachain.ai/>`_
+* `File an issue`_ if you encounter any problems
+* `Discord Chat <https://dvc.org/chat>`_
+* `Email <mailto:support@dvc.org>`_
+* `Twitter <https://twitter.com/DVCorg>`_
+
+
+DataChain Studio Platform
+=========================
+
+`DataChain Studio`_ is a proprietary solution for teams that offers:
+
+- **Centralized dataset registry** to manage data, code and dependency
+  dependencies in one place.
+- **Data Lineage** for data sources as well as derivative dataset.
+- **UI for Multimodal Data** like images, videos, and PDFs.
+- **Scalable Compute** to handle large datasets (100M+ files) and in-house
+  AI model inference.
+- **Access control** including SSO and team based collaboration.
+
+.. _PyPI: https://pypi.org/
+.. _file an issue: https://github.com/iterative/datachain/issues
+.. github-only
+.. _Contributor Guide: https://docs.datachain.ai/contributing
+.. _Pydantic: https://github.com/pydantic/pydantic
+.. _publicly available: https://radar.kit.edu/radar/en/dataset/FdJmclKpjHzLfExE.ExpBot%2B-%2BA%2Bdataset%2Bof%2B79%2Bdialogs%2Bwith%2Ban%2Bexperimental%2Bcustomer%2Bservice%2Bchatbot
+.. _SQLite: https://www.sqlite.org/
+.. _Getting Started: https://docs.datachain.ai/
+.. _DataChain Studio: https://studio.datachain.ai/

datachain-0.7.10/README.rst

@@ -0,0 +1,105 @@
+================
+|logo| DataChain
+================
+
+|PyPI| |Python Version| |Codecov| |Tests|
+
+.. |logo| image:: docs/assets/datachain.svg
+   :height: 24
+.. |PyPI| image:: https://img.shields.io/pypi/v/datachain.svg
+   :target: https://pypi.org/project/datachain/
+   :alt: PyPI
+.. |Python Version| image:: https://img.shields.io/pypi/pyversions/datachain
+   :target: https://pypi.org/project/datachain
+   :alt: Python Version
+.. |Codecov| image:: https://codecov.io/gh/iterative/datachain/graph/badge.svg?token=byliXGGyGB
+   :target: https://codecov.io/gh/iterative/datachain
+   :alt: Codecov
+.. |Tests| image:: https://github.com/iterative/datachain/actions/workflows/tests.yml/badge.svg
+   :target: https://github.com/iterative/datachain/actions/workflows/tests.yml
+   :alt: Tests
+
+DataChain is a Python-based AI-data warehouse for transforming and analyzing unstructured
+data like images, audio, videos, text and PDFs. It integrates with external storage
+(e.g. S3) to process data efficiently without data duplication and manages metadata
+in an internal database for easy and efficient querying.
+
+
+Use Cases
+=========
+
+1. **ETL.** Pythonic framework for describing and running unstructured data transformations
+   and enrichments, applying models to data, including LLMs.
+2. **Analytics.** DataChain dataset is a table that combines all the information about data
+   objects in one place + it provides dataframe-like API and vecrorized engine to do analytics
+   on these tables at scale.
+3. **Versioning.** DataChain doesn't store, require moving or copying data (unlike DVC).
+   Perfect use case is a bucket with thousands or millions of images, videos, audio, PDFs.
+
+
+Key Features
+============
+
+📂 **Multimodal Dataset Versioning.**
+   - Version unstructured data without moving or creating data copies, by supporting
+     references to S3, GCP, Azure, and local file systems.
+   - Multimodal data support: images, video, text, PDFs, JSONs, CSVs, parquet, etc.
+   - Unite files and metadata together into persistent, versioned, columnar datasets.
+
+🐍 **Python-friendly.**
+   - Operate on Python objects and object fields: float scores, strings, matrixes,
+     LLM response objects.
+   - Run Python code in a high-scale, terabytes size datasets, with built-in
+     parallelization and memory-efficient computing — no SQL or Spark required.
+
+🧠 **Data Enrichment and Processing.**
+   - Generate metadata using local AI models and LLM APIs.
+   - Filter, join, and group datasets by metadata. Search by vector embeddings.
+   - High-performance vectorized operations on Python objects: sum, count, avg, etc.
+   - Pass datasets to Pytorch and Tensorflow, or export them back into storage.
+
+
+Getting Started
+===============
+
+Visit `Quick Start <https://docs.datachain.ai/quick-start>`_ to get started with `DataChain` and learn more.
+
+
+Contributing
+============
+
+Contributions are very welcome. To learn more, see the `Contributor Guide`_.
+
+
+Community and Support
+=====================
+
+* `Docs <https://docs.datachain.ai/>`_
+* `File an issue`_ if you encounter any problems
+* `Discord Chat <https://dvc.org/chat>`_
+* `Email <mailto:support@dvc.org>`_
+* `Twitter <https://twitter.com/DVCorg>`_
+
+
+DataChain Studio Platform
+=========================
+
+`DataChain Studio`_ is a proprietary solution for teams that offers:
+
+- **Centralized dataset registry** to manage data, code and dependency
+  dependencies in one place.
+- **Data Lineage** for data sources as well as derivative dataset.
+- **UI for Multimodal Data** like images, videos, and PDFs.
+- **Scalable Compute** to handle large datasets (100M+ files) and in-house
+  AI model inference.
+- **Access control** including SSO and team based collaboration.
+
+.. _PyPI: https://pypi.org/
+.. _file an issue: https://github.com/iterative/datachain/issues
+.. github-only
+.. _Contributor Guide: https://docs.datachain.ai/contributing
+.. _Pydantic: https://github.com/pydantic/pydantic
+.. _publicly available: https://radar.kit.edu/radar/en/dataset/FdJmclKpjHzLfExE.ExpBot%2B-%2BA%2Bdataset%2Bof%2B79%2Bdialogs%2Bwith%2Ban%2Bexperimental%2Bcustomer%2Bservice%2Bchatbot
+.. _SQLite: https://www.sqlite.org/
+.. _Getting Started: https://docs.datachain.ai/
+.. _DataChain Studio: https://studio.datachain.ai/

datachain-0.7.10/docs/contributing.md

@@ -0,0 +1,111 @@
+# Contributor Guide
+
+Thank you for your interest in improving this project. This project is
+open-source under the [Apache 2.0
+license](https://opensource.org/licenses/Apache-2.0) and welcomes
+contributions in the form of bug reports, feature requests, and pull
+requests.
+
+Here is a list of important resources for contributors:
+
+-   [Source Code](https://github.com/iterative/datachain)
+-   [Documentation](https://docs.dvc.ai/datachain)
+-   [Issue Tracker](https://github.com/iterative/datachain/issues)
+-   [Code of Conduct](https://github.com/iterative/datachain?tab=coc-ov-file)
+
+## How to report a bug
+
+Report bugs on the [Issue
+Tracker](https://github.com/iterative/datachain/issues).
+
+When filing an issue, make sure to answer these questions:
+
+-   Which operating system and Python version are you using?
+-   Which version of this project are you using?
+-   What did you do?
+-   What did you expect to see?
+-   What did you see instead?
+
+The best way to get your bug fixed is to provide a test case, and/or
+steps to reproduce the issue.
+
+## How to request a feature
+
+Request features on the [Issue
+Tracker](https://github.com/iterative/datachain/issues).
+
+## How to set up your development environment
+
+You need Python 3.8+ and the following tools:
+
+-   [Nox](https://nox.thea.codes/)
+
+Install the package with development requirements:
+
+``` console
+$ pip install nox
+```
+
+## How to test the project
+
+Run the full test suite:
+
+``` console
+$ nox
+```
+
+List the available Nox sessions:
+
+``` console
+$ nox --list-sessions
+```
+
+You can also run a specific Nox session. For example, invoke the unit
+test suite like this:
+
+``` console
+$ nox --session=tests
+```
+
+Unit tests are located in the `tests` directory, and are written using
+the [pytest](https://pytest.readthedocs.io/) testing framework.
+
+## Build documentation
+
+If you've made any changes to the documentation (including changes to
+function signatures, class definitions, or docstrings that will appear
+in the API documentation), make sure it builds successfully.
+
+``` console
+$ nox -s docs
+```
+
+In order to run this locally with hot reload on changes:
+
+``` console
+$ mkdocs serve
+```
+
+## How to submit changes
+
+Open a [pull request](https://github.com/iterative/datachain/pulls) to
+submit changes to this project.
+
+Your pull request needs to meet the following guidelines for acceptance:
+
+-   The Nox test suite must pass without errors and warnings.
+-   Include unit tests. This project maintains 100% code coverage.
+-   If your changes add functionality, update the documentation
+    accordingly.
+
+Feel free to submit early, though---we can always iterate on this.
+
+To run linting and code formatting checks, you can invoke a `lint` session in nox:
+
+``` console
+$ nox -s lint
+```
+
+It is recommended to open an issue before starting work on anything.
+This will allow a chance to talk it over with the owners and validate
+your approach.

datachain-0.7.9/docs/index.md → datachain-0.7.10/docs/examples.md

@@ -1,80 +1,67 @@
-# Get Started with DataChain
 
-🔨Wrangle unstructured AI data at scale
+# Examples
 
+## DataChain Basics
 
-Datachain enables multimodal API calls and local AI inferences to run in parallel over many samples as chained operations. The resulting datasets can be saved, versioned, and sent directly to PyTorch and TensorFlow for training. Datachain can persist features of Python objects returned by AI models, and enables vectorized analytical operations over them.
+!!! example "DataChain Basics"
 
-The typical use cases are data curation, LLM analytics and validation, image segmentation, pose detection, and GenAI alignment. Datachain is especially helpful if batch operations can be optimized – for instance, when synchronous API calls can be parallelized  or where an LLM API offers batch processing.
+    Datachain is built by composing wrangling operations.
 
----
+    For example, let us consider the New Yorker Cartoon caption contest dataset, where cartoons are matched against the potential titles. Let us imagine we want to augment this dataset with synthetic scene descriptions coming from an AI model. The below code takes images from the cloud, and applies PaliGemma model to caption the first five of them and put the results in the column “scene”:
 
-`pip install datachain`
+    ```python
+    from datachain.lib.dc import Column, DataChain, File # (1)!
+    from transformers import AutoProcessor, PaliGemmaForConditionalGeneration # (2)!
 
----
+    images = DataChain.from_storage("gs://datachain-demo/newyorker_caption_contest/images", type="image")
 
-### Operation basics
+    model = PaliGemmaForConditionalGeneration.from_pretrained("google/paligemma-3b-mix-224")
+    processor = AutoProcessor.from_pretrained("google/paligemma-3b-mix-224")
 
-Datachain is built by composing wrangling operations.
+    def process(file: File) -> str:
+      image=file.read().convert("RGB")
+      inputs = processor(text="caption", images=image, return_tensors="pt")
+      generate_ids = model.generate(**inputs, max_new_tokens=100)
+      return processor.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
 
-For example, let us consider the New Yorker Cartoon caption contest dataset, where cartoons are matched against the potential titles. Let us imagine we want to augment this dataset with synthetic scene descriptions coming from an AI model. The below code takes images from the cloud, and applies PaliGemma model to caption the first five of them and put the results in the column “scene”:
-
-```python
-#
-# pip install transformers
-#
-
-from datachain.lib.dc import Column, DataChain, File
-from transformers import AutoProcessor, PaliGemmaForConditionalGeneration
-
-images = DataChain.from_storage("gs://datachain-demo/newyorker_caption_contest/images", type="image")
-
-model = PaliGemmaForConditionalGeneration.from_pretrained("google/paligemma-3b-mix-224")
-processor = AutoProcessor.from_pretrained("google/paligemma-3b-mix-224")
-
-def process(file: File) -> str:
-   image=file.read().convert("RGB")
-   inputs = processor(text="caption", images=image, return_tensors="pt")
-   generate_ids = model.generate(**inputs, max_new_tokens=100)
-   return processor.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
-
-chain = (
-      images.limit(5)
-      .settings(cache=True)
-      .map(scene=lambda file: process(file), output = str)
-      .save()
-)
-```
+    chain = (
+          images.limit(5)
+          .settings(cache=True)
+          .map(scene=lambda file: process(file), output = str)
+          .save()
+    )
+    ```
 
-Here is how we can view the results in a plot:
+    1. `pip install datachain`
+    2. `pip install transformers`
 
-```python
-import matplotlib.pyplot as plt
-import re
-from textwrap import wrap
+    Here is how we can view the results in a plot:
 
-def trim_text(text):
-    match = re.search(r'[A-Z][^.]*\.', text)
-    return match.group(0) if match else ''
+    ```python
+    import matplotlib.pyplot as plt
+    import re
+    from textwrap import wrap
 
-images = chain.collect("file")
-captions = chain.collect("scene")
-_ , axes = plt.subplots(1, len(captions), figsize=(15, 5))
+    def trim_text(text):
+        match = re.search(r'[A-Z][^.]*\.', text)
+        return match.group(0) if match else ''
 
-for ax, img, caption in zip(axes, images, captions):
-    ax.imshow(img.read(),cmap='gray')
-    ax.axis('off')
-    wrapped_caption = "\n".join(wrap(trim_text(caption), 30))
-    ax.set_title(wrapped_caption, fontsize=6)
+    images = chain.collect("file")
+    captions = chain.collect("scene")
+    _ , axes = plt.subplots(1, len(captions), figsize=(15, 5))
 
-plt.show()
-```
+    for ax, img, caption in zip(axes, images, captions):
+        ax.imshow(img.read(),cmap='gray')
+        ax.axis('off')
+        wrapped_caption = "\n".join(wrap(trim_text(caption), 30))
+        ax.set_title(wrapped_caption, fontsize=6)
 
-![Untitled](assets/captioned_cartoons.png)
+    plt.show()
+    ```
 
-If interested to see more multimodal examples for DataChain, please follow this tutorial:
+    ![Untitled](assets/captioned_cartoons.png)
 
-[https://github.com/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb](https://github.com/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb) [Google Colab](https://colab.research.google.com/github/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb)
+If interested to see more examples, please check out the [tutorials](tutorials.md).
 
 ### Handling Python objects
 
@@ -188,7 +175,7 @@ Datachain avoids redundant operations. Execution is triggered only when a downst
 
 “Save” operation nails execution results and automatically refers to them every time the downstream functions ask for data. Saving without an explicit name generates an auto-named dataset which serves the same purpose.
 
-Datachain natively supports parallelism in execution. If an API or a local model supports parallel requests, the `settings` operator can split the load across multiple workers (see the [code example above](https://www.notion.so/DataChain-Getting-Started-3ed9414febac48f888f90cdaa2ca7667?pvs=21))
+Datachain natively supports parallelism in execution. If an API or a local model supports parallel requests, the `settings` operator can split the load across multiple workers (see the [code example above](#handling-python-objects))
 
 ### Reading external metadata
 
@@ -279,7 +266,7 @@ images_with_dogs.select("annotations", "file.name").show()
 ```
 For in-depth review of working with JSON metadata, please follow this tutorial:
 
-[https://github.com/iterative/datachain-examples/blob/main/formats/json-metadata-tutorial.ipynb](https://github.com/iterative/datachain-examples/blob/main/formats/json-metadata-tutorial.ipynb) [Google Colab](https://colab.research.google.com/github/iterative/datachain-examples/blob/main/formats/json-metadata-tutorial.ipynb)
+[GitHub](https://github.com/iterative/datachain-examples/blob/main/formats/json-metadata-tutorial.ipynb) or [Google Colab](https://colab.research.google.com/github/iterative/datachain-examples/blob/main/formats/json-metadata-tutorial.ipynb)
 
 ### Passing data to training
 
@@ -299,4 +286,4 @@ train(loader, model, optimizer)
 
 See a larger example for CLIP fine-tuning here:
 
-[https://github.com/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb](https://github.com/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb) [Google Colab](https://colab.research.google.com/github/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb)
+[GitHub](https://github.com/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb) or [Google Colab](https://colab.research.google.com/github/iterative/datachain-examples/blob/main/multimodal/clip_fine_tuning.ipynb)