YCB Downloader (ycbust)

ycbust is a Rust library and CLI for downloading and extracting assets from the YCB Object and Model Set. It is aimed at rendering, robotics, and simulation workflows that need a predictable local YCB layout with minimal setup.

Features

• Library and CLI interfaces for the same download/extract workflow
• Fast presets for representative, tbp-standard, tbp-similar, and all
• google_16k meshes by default, with --full for extra Berkeley assets
• Validation helpers for checking that benchmark objects are fully present
• Progress bars for local downloads
• Optional s3 feature for streaming extracted assets directly to S3

Installation

Install the CLI from crates.io:

cargo install ycbust

Install with S3 support:

cargo install ycbust --features s3

Prebuilt binaries are also available on the GitHub releases page.

Quick Start

The CLI uses subcommands. The default local output path is your OS temp directory plus ycb:

• Linux/macOS: /tmp/ycb
• Windows: %TEMP%\ycb

Download the default TBP standard subset:

ycbust download

Download a quick 3-object smoke-test set:

ycbust download --subset representative

Download specific objects to a custom directory:

ycbust download --output-dir ./data/ycb --objects 006_mustard_bottle 011_banana

Download all supported file types for the standard subset:

ycbust download --full

Validate a local dataset directory:

ycbust validate --output-dir ./data/ycb --subset tbp-standard

List the objects in a built-in subset:

ycbust list --subset tbp-similar

Fetch the full upstream object list from YCB S3:

ycbust list --subset all --fetch

Subsets

• representative: 3 common objects for quick end-to-end checks
• tbp-standard: the TBP standard 10-object benchmark set
• tbp-similar: the TBP harder 10-object discrimination set
• all: every object advertised by the YCB dataset index

Output Layout

For a typical google_16k download, ycbust produces:

<output-dir>/
  003_cracker_box/
    google_16k/
      textured.obj
      texture_map.png
      textured.mtl
      ...

For rendering workflows, point your asset loader at google_16k/textured.obj.

Library Usage

The crate can also be used directly from Rust:

use std::path::Path;
use ycbust::{download_ycb, DownloadOptions, Subset};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    download_ycb(
        Subset::TbpStandard,
        Path::new("./data/ycb"),
        DownloadOptions::default(),
    )
    .await?;

    Ok(())
}

API docs: docs.rs/ycbust

S3 Streaming

With the s3 feature enabled, downloads can be extracted directly into an S3 bucket:

ycbust download --output-dir s3://my-bucket/ycb --subset tbp-standard --region us-east-1

Use --profile <name> if you do not want to rely on the default AWS credential chain.

Development

This repo uses just for common tasks:

just test
just test-s3
just lint
just lint-s3
just ci
just ci-s3

This is a public utility crate, so changes should stay small, general-purpose, and easy to verify.