Skip to main content

A Distributed DataFrame library for large scale complex data processing.

Project description

Daft dataframes can load any data such as PDF documents, images, protobufs, csv, parquet and audio files into a table dataframe structure for easy querying

Github Actions tests PyPI latest tag

WebsiteDocsInstallation10-minute tour of DaftCommunity and Support

Daft: the distributed Python dataframe for complex data

Daft is a fast, Pythonic and scalable open-source dataframe library built for Python and Machine Learning workloads.

Daft is currently in its Alpha release phase - please expect bugs and rapid improvements to the project. We welcome user feedback/feature requests in our Discussions forums

Table of Contents

About Daft

The Daft dataframe is a table of data with rows and columns. Columns can contain any Python objects, which allows Daft to support rich complex data types such as images, audio, video and more.

  1. Any Data: Columns can contain any Python objects, which means that the Python libraries you already use for running machine learning or custom data processing will work natively with Daft!

  2. Notebook Computing: Daft is built for the interactive developer experience on a notebook - intelligent caching/query optimizations accelerates your experimentation and data exploration.

  3. Distributed Computing: Rich complex formats such as images can quickly outgrow your local laptop’s computational resources - Daft integrates natively with Ray for running dataframes on large clusters of machines with thousands of CPUs/GPUs.

Getting Started

Installation

Install Daft with pip install getdaft.

For more advanced installations (e.g. installing from source or with extra dependencies such as Ray and AWS utilities), please see our Installation Guide

Quickstart

Check out our 10-minute quickstart!

In this example, we load images from an AWS S3 bucket and run a simple function to generate thumbnails for each image:

from daft import DataFrame, lit

import io
from PIL import Image

def get_thumbnail(img: Image.Image) -> Image.Image:
    """Simple function to make an image thumbnail"""
    imgcopy = img.copy()
    imgcopy.thumbnail((48, 48))
    return imgcopy

# Load a dataframe from files in an S3 bucket
df = DataFrame.from_files("s3://daft-public-data/laion-sample-images/*")

# Get the AWS S3 url of each image
df = df.select(lit("s3://").str.concat(df["name"]).alias("s3_url"))

# Download images and load as a PIL Image object
df = df.with_column("image", df["s3_url"].url.download().apply(lambda data: Image.open(io.BytesIO(data))))

# Generate thumbnails from images
df = df.with_column("thumbnail", df["image"].apply(get_thumbnail))

df.show(3)

Dataframe code to load a folder of images from AWS S3 and create thumbnails

More Resources

  • 10-minute tour of Daft - learn more about Daft’s full range of capabilities including dataloading from URLs, joins, user-defined functions (UDF), groupby, aggregations and more.

  • User Guide - take a deep-dive into each topic within Daft

  • API Reference - API reference for public classes/functions of Daft

Contributing

To start contributing to Daft, please read CONTRIBUTING.md

Telemetry

To help improve Daft, we collect non-identifiable data.

To disable this behavior, set the following environment variable: DAFT_ANALYTICS_ENABLED=0

The data that we collect is:

  1. Non-identifiable: events are keyed by a session ID which is generated on import of Daft

  2. Metadata-only: we do not collect any of our users’ proprietary code or data

  3. For development only: we do not buy or sell any user data

Please see our documentation for more details.

License

Daft has an Apache 2.0 license - please see the LICENSE file.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

getdaft-0.0.22.tar.gz (644.8 kB view details)

Uploaded Source

Built Distributions

getdaft-0.0.22-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.7+ manylinux: glibc 2.17+ x86-64

getdaft-0.0.22-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.3 MB view details)

Uploaded CPython 3.7+ manylinux: glibc 2.17+ ARM64

getdaft-0.0.22-cp37-abi3-macosx_11_0_arm64.whl (1.3 MB view details)

Uploaded CPython 3.7+ macOS 11.0+ ARM64

getdaft-0.0.22-cp37-abi3-macosx_10_7_x86_64.whl (1.5 MB view details)

Uploaded CPython 3.7+ macOS 10.7+ x86-64

File details

Details for the file getdaft-0.0.22.tar.gz.

File metadata

  • Download URL: getdaft-0.0.22.tar.gz
  • Upload date:
  • Size: 644.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.15

File hashes

Hashes for getdaft-0.0.22.tar.gz
Algorithm Hash digest
SHA256 d1d33d0765e9b10b2105c1f879b936de684e0f96018e2583d484919a71a9dd7a
MD5 13b4039a7a81afabc156285b0d9ca36b
BLAKE2b-256 767a51d7438292cd9c158179ba80428c02cf2c0b6294d501232cf8ca9e4cc45a

See more details on using hashes here.

File details

Details for the file getdaft-0.0.22-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for getdaft-0.0.22-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 fafdda53051fab76aed41bc718e66661665bb4a047b777e783dbbfe02eb0f4fb
MD5 f465f177e0f5a37ac23653132c449107
BLAKE2b-256 dad1d73dae39293338e81583800375a81204df8633c276701462f8de466c8120

See more details on using hashes here.

File details

Details for the file getdaft-0.0.22-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for getdaft-0.0.22-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 d087a45f03d40761eb736c78cef282f81e1a21fc316d0d316c808d7e704176ce
MD5 e9e2a65d1f749d98b5b62764b63f38cc
BLAKE2b-256 3c0dda8059eedaed223ea5b77e3ee4cf4198005c26138d2690a9e7a1520323cd

See more details on using hashes here.

File details

Details for the file getdaft-0.0.22-cp37-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for getdaft-0.0.22-cp37-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 82920a5f82e3caea246486b417a857e56797ec5908d1f0b4bbf9e4f72e7b55cb
MD5 49dd2105856577bafe971ee5c394140a
BLAKE2b-256 dec43287f6d90f00125ca14ea3cf10a89316be52a69c759cddd1772536e0ad1c

See more details on using hashes here.

File details

Details for the file getdaft-0.0.22-cp37-abi3-macosx_10_7_x86_64.whl.

File metadata

File hashes

Hashes for getdaft-0.0.22-cp37-abi3-macosx_10_7_x86_64.whl
Algorithm Hash digest
SHA256 cf7e59645f2a118f68c60bb403ab33f423388d3d1c820466053d48310d1e42e3
MD5 bab6d6cdcd58402693a5ac27b726eea8
BLAKE2b-256 8c7c82e5e98e89d5043ede2b255426b970bfb75d835d4833aeadc135f6172aff

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page