pixeltable 0.3.10__py3-none-any.whl → 0.3.12__py3-none-any.whl

pixeltable/catalog/path_dict.py

@@ -1,169 +0,0 @@
-from __future__ import annotations
-
-import copy
-import logging
-from typing import Optional
-from uuid import UUID
-
-import sqlalchemy.orm as orm
-
-from pixeltable import exceptions as excs
-from pixeltable.env import Env
-from pixeltable.metadata import schema
-
-from .dir import Dir
-from .path import Path
-from .schema_object import SchemaObject
-
-_logger = logging.getLogger('pixeltable')
-
-
-class PathDict:
-    """Keep track of all paths in a Db instance"""
-
-    def __init__(self):
-        self.dir_contents: dict[UUID, dict[str, SchemaObject]] = {}
-        self.schema_objs: dict[UUID, SchemaObject] = {}
-
-        # load dirs
-        with orm.Session(Env.get().engine, future=True) as session:
-            _ = [dir_record for dir_record in session.query(schema.Dir).all()]
-            self.schema_objs = {
-                dir_record.id: Dir(dir_record.id, dir_record.parent_id, schema.DirMd(**dir_record.md).name)
-                for dir_record in session.query(schema.Dir).all()
-            }
-
-        # identify root dir
-        root_dirs = [dir for dir in self.schema_objs.values() if dir._dir_id is None]
-        assert len(root_dirs) == 1
-        self.root_dir = root_dirs[0]
-
-        # build dir_contents
-        def record_dir(dir: SchemaObject) -> None:
-            assert isinstance(dir, Dir)
-            if dir._id in self.dir_contents:
-                return
-            else:
-                self.dir_contents[dir._id] = {}
-            if dir._dir_id is not None:
-                record_dir(self.schema_objs[dir._dir_id])
-                self.dir_contents[dir._dir_id][dir._name] = dir
-
-        for dir in self.schema_objs.values():
-            record_dir(dir)
-
-    def _resolve_path(self, path: Path) -> SchemaObject:
-        """Resolve the path to a SchemaObject.
-
-        Args:
-            path: path to resolve
-
-        Returns:
-            SchemaObject at the path.
-
-        Raises:
-            Error if path is invalid or does not exist.
-        """
-        schema_obj = self.get_object(path)
-        if schema_obj is None:
-            raise excs.Error(f'No such path: {str(path)}')
-        return schema_obj
-
-    def get_object(self, path: Path) -> Optional[SchemaObject]:
-        """Get the object at the given path, if any.
-
-        Args:
-            path: path to object
-
-        Returns:
-            SchemaObject at the path if it exists, None otherwise.
-
-        Raises:
-            Error if path is invalid.
-        """
-        if path.is_root:
-            return self.root_dir
-        dir = self.root_dir
-        for i, component in enumerate(path.components):
-            if component not in self.dir_contents[dir._id]:
-                if i == len(path.components) - 1:
-                    return None
-                raise excs.Error(f'No such path: {".".join(path.components[: i + 1])}')
-            schema_obj = self.dir_contents[dir._id][component]
-            if i < len(path.components) - 1:
-                if not isinstance(schema_obj, Dir):
-                    raise excs.Error(f'Not a directory: {".".join(path.components[: i + 1])}')
-                dir = schema_obj
-        return schema_obj
-
-    def __getitem__(self, path: Path) -> SchemaObject:
-        return self._resolve_path(path)
-
-    def get_schema_obj(self, id: UUID) -> Optional[SchemaObject]:
-        return self.schema_objs.get(id)
-
-    def add_schema_obj(self, dir_id: UUID, name: str, val: SchemaObject) -> None:
-        self.dir_contents[dir_id][name] = val
-        self.schema_objs[val._id] = val
-
-    def __setitem__(self, path: Path, val: SchemaObject) -> None:
-        parent_dir = self._resolve_path(path.parent)
-        assert path.name not in self.dir_contents[parent_dir._id]
-        self.schema_objs[val._id] = val
-        self.dir_contents[parent_dir._id][path.name] = val
-        if isinstance(val, Dir):
-            self.dir_contents[val._id] = {}
-
-    def __delitem__(self, path: Path) -> None:
-        parent_dir = self._resolve_path(path.parent)
-        assert path.name in self.dir_contents[parent_dir._id]
-        obj = self.dir_contents[parent_dir._id][path.name]
-        del self.dir_contents[parent_dir._id][path.name]
-        if isinstance(obj, Dir):
-            del self.dir_contents[obj._id]
-        del self.schema_objs[obj._id]
-
-    def move(self, from_path: Path, to_path: Path) -> None:
-        from_dir = self._resolve_path(from_path.parent)
-        assert isinstance(from_dir, Dir)
-        assert from_path.name in self.dir_contents[from_dir._id]
-        obj = self.dir_contents[from_dir._id][from_path.name]
-        del self.dir_contents[from_dir._id][from_path.name]
-        to_dir = self._resolve_path(to_path.parent)
-        assert to_path.name not in self.dir_contents[to_dir._id]
-        self.dir_contents[to_dir._id][to_path.name] = obj
-
-    def check_is_valid(self, path: Path, expected: Optional[type[SchemaObject]]) -> None:
-        """Check that path is valid and that the object at path has the expected type.
-
-        Args:
-            path: path to check
-            expected: expected type of object at path or None if object should not exist
-
-        Raises:
-            Error if path is invalid or object at path has wrong type
-        """
-        # check for existence
-        obj = self.get_object(path)
-        if expected is not None:
-            if obj is None:
-                raise excs.Error(f'No such path: {str(path)}')
-            if not isinstance(obj, expected):
-                raise excs.Error(
-                    f'{str(path)} needs to be a {expected._display_name()} but is a {type(obj)._display_name()}'
-                )
-        if expected is None and obj is not None:
-            raise excs.Error(f"{type(obj)._display_name()} '{str(path)}' already exists")
-
-    def get_children(self, parent: Path, child_type: Optional[type[SchemaObject]], recursive: bool) -> list[Path]:
-        dir = self._resolve_path(parent)
-        if not isinstance(dir, Dir):
-            raise excs.Error(f'{str(parent)} is a {type(dir)._display_name()}, not a directory')
-        matches = [
-            obj for obj in self.dir_contents[dir._id].values() if child_type is None or isinstance(obj, child_type)
-        ]
-        result = [copy.copy(parent).append(obj._name) for obj in matches]
-        if recursive:
-            for dir in [obj for obj in self.dir_contents[dir._id].values() if isinstance(obj, Dir)]:
-                result.extend(self.get_children(copy.copy(parent).append(dir._name), child_type, recursive))
-        return result

pixeltable-0.3.10.dist-info/METADATA

@@ -1,382 +0,0 @@
-Metadata-Version: 2.3
-Name: pixeltable
-Version: 0.3.10
-Summary: AI Data Infrastructure: Declarative, Multimodal, and Incremental
-License: Apache-2.0
-Keywords: data-science,machine-learning,database,ai,computer-vision,chatbot,ml,artificial-intelligence,feature-engineering,multimodal,mlops,feature-store,vector-database,llm,genai
-Author: Pixeltable, Inc.
-Author-email: contact@pixeltable.com>
-Requires-Python: >=3.9,<4.0
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-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: Programming Language :: Python :: 3.13
-Classifier: Topic :: Database
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Dist: av (>=10.0.0)
-Requires-Dist: beautifulsoup4 (>=4.0.0)
-Requires-Dist: cloudpickle (>=2.2.1)
-Requires-Dist: ftfy (>=6.2.0)
-Requires-Dist: httpcore (>=1.0.3)
-Requires-Dist: httpx (>=0.27)
-Requires-Dist: jinja2 (>=3.1.3)
-Requires-Dist: jmespath (>=1.0.1)
-Requires-Dist: jsonschema (>=4.1.0)
-Requires-Dist: lxml (>=5.0)
-Requires-Dist: more-itertools (>=10.2)
-Requires-Dist: nest_asyncio (>=1.5)
-Requires-Dist: numpy (>=1.25,<2.0)
-Requires-Dist: pandas (>=2.0,<3.0)
-Requires-Dist: pgvector (>=0.2.1)
-Requires-Dist: pillow (>=9.3.0)
-Requires-Dist: pixeltable-pgserver (==0.3.1)
-Requires-Dist: psutil (>=5.9.5)
-Requires-Dist: psycopg[binary] (>=3.1.18)
-Requires-Dist: puremagic (>=1.20)
-Requires-Dist: pyarrow (>=13.0.0)
-Requires-Dist: pydantic (>=2.7.4)
-Requires-Dist: pyiceberg (>=0.6.0)
-Requires-Dist: pymupdf (>=1.24.1)
-Requires-Dist: pyyaml (>=6.0.1)
-Requires-Dist: requests (>=2.31.0)
-Requires-Dist: sqlalchemy (>=2.0.23)
-Requires-Dist: tenacity (>=8.2)
-Requires-Dist: toml (>=0.10)
-Requires-Dist: tqdm (>=4.64)
-Project-URL: Documentation, https://docs.pixeltable.com/
-Project-URL: Homepage, https://pixeltable.com/
-Project-URL: Repository, https://github.com/pixeltable/pixeltable
-Description-Content-Type: text/markdown
-
-<div align="center">
-<img src="https://raw.githubusercontent.com/pixeltable/pixeltable/main/docs/resources/pixeltable-logo-large.png"
-     alt="Pixeltable" width="50%" />
-<br></br>
-
-<h2>Build Multimodal AI Apps with Declarative Data Infrastructure</h2>
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-0530AD.svg)](https://opensource.org/licenses/Apache-2.0)
-![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pixeltable?logo=python&logoColor=white&)
-![Platform Support](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-E5DDD4)
-<br>
-[![tests status](https://github.com/pixeltable/pixeltable/actions/workflows/pytest.yml/badge.svg)](https://github.com/pixeltable/pixeltable/actions/workflows/pytest.yml)
-[![tests status](https://github.com/pixeltable/pixeltable/actions/workflows/nightly.yml/badge.svg)](https://github.com/pixeltable/pixeltable/actions/workflows/nightly.yml)
-[![PyPI Package](https://img.shields.io/pypi/v/pixeltable?color=4D148C)](https://pypi.org/project/pixeltable/)
-[![My Discord (1306431018890166272)](https://img.shields.io/badge/💬-Discord-%235865F2.svg)](https://discord.gg/QPyqFYx2UN)
-<a target="_blank" href="https://huggingface.co/Pixeltable">
-  <img src="https://img.shields.io/badge/🤗-HF Space-FF7D04" alt="Visit our Hugging Face space"/>
-</a>
-
-[Installation](https://docs.pixeltable.com/docs/installation) |
-[Documentation](https://docs.pixeltable.com/docs/overview/quick-start) |
-[API Reference](https://pixeltable.github.io/pixeltable/) |
-[Code Samples](https://github.com/pixeltable/pixeltable?tab=readme-ov-file#-code-samples) |
-[Computer Vision](https://docs.pixeltable.com/docs/object-detection-in-videos) |
-[LLM](https://docs.pixeltable.com/docs/document-indexing-and-rag)
-</div>
-
-## 🔍 What is Pixeltable?
-Pixeltable is a declarative data infrastructure for building multimodal AI applications, enabling incremental storage, transformation, indexing, and orchestration of your data.
-- **Data Ingestion**: Unified interface for all [data types](https://docs.pixeltable.com/docs/datastore/bringing-data) (images, videos, audio, documents, URLs, blob storage, structured data)
-- **Data Transformation**: [Chunking](https://docs.pixeltable.com/docs/datastore/views), [embedding](https://docs.pixeltable.com/docs/datastore/embedding-index), and processing with declarative [computed columns](https://docs.pixeltable.com/docs/datastore/computed-columns)
-- **Indexing & Storage**: Type-safe tables with [built-in vector indexing](https://docs.pixeltable.com/docs/cookbooks/search/website)
-- **Query & Retrieval**: [Queries](https://docs.pixeltable.com/docs/datastore/filtering-and-selecting) combining filtering, sorting, and similarity search
-- **Inference & Generation**: [Integration](https://docs.pixeltable.com/docs/integrations/frameworks#cloud-llm-providers) with AI models (OpenAI, Anthropic, PyTorch, YOLOX, DETR, Together, Hugging Face and more...)
-
-All with your [custom functions (UDFs)](https://docs.pixeltable.com/docs/datastore/custom-functions), and built-in caching, versioning, lineage tracking, and incremental computation.
-
-## 💾 Installation
-
-```python
-pip install pixeltable
-```
-
-**Pixeltable is persistent. Unlike in-memory Python libraries such as Pandas, Pixeltable is a database.**
-
-## 💡 Getting Started
-
-Learn how to create tables, populate them with data, and enhance them with built-in or user-defined transformations.
-
-| Topic | Notebook | Topic | Notebook |
-|:----------|:-----------------|:-------------------------|:---------------------------------:|
-| 10-Minute Tour of Pixeltable    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/pixeltable-basics.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> | Tables and Data Operations    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/fundamentals/tables-and-data-operations.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |
-| User-Defined Functions (UDFs)    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/feature-guides/udfs-in-pixeltable.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> | Object Detection Models | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/use-cases/object-detection-in-videos.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |
-| Incremental Prompt Engineering | <a target="_blank" href="https://colab.research.google.com/github/mistralai/cookbook/blob/main/third_party/Pixeltable/incremental_prompt_engineering_and_model_comparison.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Github"/> | Working with External Files    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/feature-guides/working-with-external-files.ipynb"> <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> </a> |
-| Integrating with Label Studio    | <a target="_blank" href="https://docs.pixeltable.com/docs/cookbooks/vision/label-studio"> <img src="https://img.shields.io/badge/📚 Documentation-013056" alt="Visit our documentation"/></a> | Audio/Video Transcript Indexing    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/use-cases/audio-transcriptions.ipynb">  <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> |
-| Multimodal Application    | <a target="_blank" href="https://huggingface.co/spaces/Pixeltable/Multimodal-Powerhouse"> <img src="https://img.shields.io/badge/🤗-Gradio App-FF7D04" alt="Visit our Hugging Face Space"/></a> | Document Indexing and RAG    | <a target="_blank" href="https://colab.research.google.com/github/pixeltable/pixeltable/blob/release/docs/notebooks/use-cases/rag-demo.ipynb">  <img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/> |
-| Context-Aware Discord Bot    | <a target="_blank" href="https://github.com/pixeltable/pixeltable/blob/main/docs/sample-apps/context-aware-discord-bot"> <img src="https://img.shields.io/badge/%F0%9F%92%AC-Discord Bot-%235865F2.svg" alt="Visit our documentation"/></a> | Image/Text Similarity Search  | <a target="_blank" href="https://github.com/pixeltable/pixeltable/tree/main/docs/sample-apps/text-and-image-similarity-search-nextjs-fastapi">  <img src="https://img.shields.io/badge/🖥️-Next.js + FastAPI-black.svg" alt="Open In Colab"/> |
-
-## 🧱 Code Samples
-
-### Import media data into Pixeltable (videos, images, audio...)
-
-```python
-import pixeltable as pxt
-
-v = pxt.create_table('external_data.videos', {'video': pxt.Video})
-
-prefix = 's3://multimedia-commons/'
-paths = [
-    'data/videos/mp4/ffe/ffb/ffeffbef41bbc269810b2a1a888de.mp4',
-    'data/videos/mp4/ffe/feb/ffefebb41485539f964760e6115fbc44.mp4',
-    'data/videos/mp4/ffe/f73/ffef7384d698b5f70d411c696247169.mp4'
-]
-v.insert({'video': prefix + p} for p in paths)
-```
-
-Learn how to [work with data in Pixeltable](https://docs.pixeltable.com/docs/datastore/tables-and-operations).
-
-### Object detection in images using DETR model
-
-```python
-import pixeltable as pxt
-from pixeltable.functions import huggingface
-
-# Create a table to store data persistently
-t = pxt.create_table('image', {'image': pxt.Image})
-
-# Insert some images
-prefix = 'https://upload.wikimedia.org/wikipedia/commons'
-paths = [
-    '/1/15/Cat_August_2010-4.jpg',
-    '/e/e1/Example_of_a_Dog.jpg',
-    '/thumb/b/bf/Bird_Diversity_2013.png/300px-Bird_Diversity_2013.png'
-]
-t.insert({'image': prefix + p} for p in paths)
-
-# Add a computed column for image classification
-t.add_computed_column(classification=huggingface.detr_for_object_detection(
-    t.image,
-    model_id='facebook/detr-resnet-50'
-))
-
-# Retrieve the rows where cats have been identified
-t.select(animal = t.image,
-         classification = t.classification.label_text[0]) \
-.where(t.classification.label_text[0]=='cat').head()
-```
-
-Learn about computed columns and object detection:
-[Comparing object detection models](https://docs.pixeltable.com/docs/examples/use-cases#multimodal-processing).
-
-### Extend Pixeltable's capabilities with user-defined functions
-
-```python
-@pxt.udf
-def draw_boxes(img: PIL.Image.Image, boxes: list[list[float]]) -> PIL.Image.Image:
-    result = img.copy()  # Create a copy of `img`
-    d = PIL.ImageDraw.Draw(result)
-    for box in boxes:
-        d.rectangle(box, width=3)  # Draw bounding box rectangles on the copied image
-    return result
-```
-
-Learn more about user-defined functions:
-[UDFs in Pixeltable](https://docs.pixeltable.com/docs/datastore/custom-functions).
-
-### Automate data operations with views, e.g., split documents into chunks
-
-```python
-# In this example, the view is defined by iteration over the chunks of a DocumentSplitter
-chunks_table = pxt.create_view(
-    'rag_demo.chunks',
-    documents_table,
-    iterator=DocumentSplitter.create(
-        document=documents_table.document,
-        separators='token_limit', limit=300)
-)
-```
-
-Learn how to leverage views to build your
-[RAG workflow](https://docs.pixeltable.com/docs/cookbooks/chat/memory).
-
-### Evaluate model performance
-
-```python
-# The computation of the mAP metric can become a query over the evaluation output
-frames_view.select(mean_ap(frames_view.eval_yolox_tiny), mean_ap(frames_view.eval_yolox_m)).show()
-```
-
-Learn how to leverage Pixeltable for [Model analytics](https://github.com/pixeltable/pixeltable/blob/main/docs/notebooks/use-cases/object-detection-in-videos.ipynb).
-
-### Working with inference services
-
-```python
-chat_table = pxt.create_table('together_demo.chat', {'input': pxt.String})
-
-# The chat-completions API expects JSON-formatted input:
-messages = [{'role': 'user', 'content': chat_table.input}]
-
-# This example shows how additional parameters from the Together API can be used in Pixeltable
-chat_table.add_computed_column(
-    output=chat_completions(
-        messages=messages,
-        model='mistralai/Mixtral-8x7B-Instruct-v0.1',
-        max_tokens=300,
-        stop=['\n'],
-        temperature=0.7,
-        top_p=0.9,
-        top_k=40,
-        repetition_penalty=1.1,
-        logprobs=1,
-        echo=True
-    )
-)
-chat_table.add_computed_column(
-    response=chat_table.output.choices[0].message.content
-)
-
-# Start a conversation
-chat_table.insert([
-    {'input': 'How many species of felids have been classified?'},
-    {'input': 'Can you make me a coffee?'}
-])
-chat_table.select(chat_table.input, chat_table.response).head()
-```
-
-Learn how to interact with inference services such as [Together AI](https://github.com/pixeltable/pixeltable/blob/main/docs/notebooks/integrations/working-with-together.ipynb) in Pixeltable.
-
-### Text and image similarity search on video frames with embedding indexes
-
-```python
-import pixeltable as pxt
-from pixeltable.functions.huggingface import clip
-from pixeltable.iterators import FrameIterator
-import PIL.Image
-
-video_table = pxt.create_table('videos', {'video': pxt.Video})
-
-video_table.insert([{'video': '/video.mp4'}])
-
-frames_view = pxt.create_view(
-    'frames', video_table, iterator=FrameIterator.create(video=video_table.video))
-
-# Create an index on the 'frame' column that allows text and image search
-frames_view.add_embedding_index('frame', embed=clip.using('openai/clip-vit-base-patch32'))
-
-# Now we will retrieve images based on a sample image
-sample_image = '/image.jpeg'
-sim = frames_view.frame.similarity(sample_image)
-frames_view.order_by(sim, asc=False).limit(5).select(frames_view.frame, sim=sim).collect()
-
-# Now we will retrieve images based on a string
-sample_text = 'red truck'
-sim = frames_view.frame.similarity(sample_text)
-frames_view.order_by(sim, asc=False).limit(5).select(frames_view.frame, sim=sim).collect()
-```
-
-Learn how to work with [Embedding and Vector Indexes](https://docs.pixeltable.com/docs/datastore/embedding-index).
-
-## 🔄 AI Stack Comparison
-
-### 🎯 Computer Vision Workflows
-
-| Requirement | Traditional | Pixeltable |
-|-------------|---------------------|------------|
-| Frame Extraction | ffmpeg + custom code | Automatic via FrameIterator |
-| Object Detection | Multiple scripts + caching | Single computed column |
-| Video Indexing | Custom pipelines + Vector DB | Native similarity search |
-| Annotation Management | Separate tools + custom code | Label Studio integration |
-| Model Evaluation | Custom metrics pipeline | Built-in mAP computation |
-
-### 🤖 LLM Workflows
-
-| Requirement | Traditional | Pixeltable |
-|-------------|---------------------|------------|
-| Document Chunking | Tool + custom code | Native DocumentSplitter |
-| Embedding Generation | Separate pipeline + caching | Computed columns |
-| Vector Search | External vector DB | Built-in vector indexing |
-| Prompt Management | Custom tracking solution | Version-controlled columns |
-| Chain Management | Tool + custom code | Computed column DAGs |
-
-### 🎨 Multimodal Workflows
-
-| Requirement | Traditional | Pixeltable |
-|-------------|---------------------|------------|
-| Data Types | Multiple storage systems | Unified table interface |
-| Cross-Modal Search | Complex integration | Native similarity support |
-| Pipeline Orchestration | Multiple tools (Airflow, etc.) | Single declarative interface |
-| Asset Management | Custom tracking system | Automatic lineage |
-| Quality Control | Multiple validation tools | Computed validation columns |
-
-## ❓ FAQ
-
-### What problems does Pixeltable solve?
-
-Today's solutions for AI app development require extensive custom coding and infrastructure plumbing.
-Tracking lineage and versions between and across data transformations, models, and deployments is cumbersome.
-Pixeltable lets ML Engineers and Data Scientists focus on exploration, modeling, and app development without
-dealing with the customary data plumbing.
-
-### What does Pixeltable provide me with? Pixeltable provides:
-
-- Data storage and versioning
-- Combined Data and Model Lineage
-- Indexing (e.g. embedding vectors) and Data Retrieval
-- Orchestration of multimodal workloads
-- Incremental updates
-- Code is automatically production-ready
-
-### Why should you use Pixeltable?
-
-- **It gives you transparency and reproducibility**
-  - All generated data is automatically recorded and versioned
-  - You will never need to re-run a workload because you lost track of the input data
-- **It saves you money**
-  - All data changes are automatically incremental
-  - You never need to re-run pipelines from scratch because you’re adding data
-- **It integrates with any existing Python code or libraries**
-  - Bring your ever-changing code and workloads
-  - You choose the models, tools, and AI practices (e.g., your embedding model for a vector index);
-    Pixeltable orchestrates the data
-
-### What is Pixeltable not providing?
-
-- Pixeltable is not a low-code, prescriptive AI solution. We empower you to use the best frameworks and techniques for
-  your specific needs.
-- We do not aim to replace your existing AI toolkit, but rather enhance it by streamlining the underlying data
-  infrastructure and orchestration.
-
-> [!TIP]
-> Check out the [Integrations](https://docs.pixeltable.com/docs/integrations/frameworks) section, and feel free to submit
-> a request for additional ones.
-
-## 🤝 Contributing to Pixeltable
-
-We're excited to welcome contributions from the community! Here's how you can get involved:
-
-### 🐛 Report Issues
-
-- Found a bug? [Open an issue](https://github.com/pixeltable/pixeltable/issues)
-- Include steps to reproduce and environment details
-
-### 💡 Submit Changes
-
-- Fork the repository
-- Create a feature branch
-- Submit a [pull request](https://github.com/pixeltable/pixeltable/pulls)
-- See our [Contributing Guide](CONTRIBUTING.md) for detailed instructions
-
-### 💬 Join the Discussion
-
-- Have questions? Start a [Discussion](https://github.com/pixeltable/pixeltable/discussions)
-- Share your Pixeltable projects and use cases
-- Help others in the community
-
-### 📝 Improve Documentation
-
-- Suggest examples and tutorials
-- Propose improvements
-
-## 🏢 License
-
-This library is licensed under the Apache 2.0 License.
-