Skip to main content

solarian-diffusion

A policy plugin for the Solarian framework that trains and serves a UMI DiffusionUnetTimmPolicy.

Unlike a skill plugin (a behavior), a policy plugin is keyed to a model family/library and ships both halves of a policy:

  • DiffusionTrainer — a solarian.core.ai.system1.PolicyTrainer that trains the policy by reusing the UMI diffusion_policy workspace (the accelerate multi-GPU loop). Discovered by solarian train through the solarian.trainers entry point (trainer: diffusion).
  • DiffusionPolicyServer — a solarian.core.ai.system1.PolicyServer that serves a trained checkpoint over HTTP.

The UMI model + training code (the diffusion_policy package — timm workspace, UmiDataset, model code, and the bundled Hydra configs — plus the small umi.common.pose_util helper) is vendored directly into this plugin, so there is no separate UMI install to manage. The HTTP-serving stack, hydra-core, omegaconf and dill ship with solarian core; only the ML runtimes (PyTorch, diffusers, timm, …) are optional extras.

Install

# Trainer + server discovery only (no torch):
pip install solarian-diffusion

# Training (accelerate + the diffusion model stack):
pip install "solarian-diffusion[train]"

# Serving a checkpoint:
pip install "solarian-diffusion[serve]"

Train

Add a training file, conf/training/<name>.yaml, and set trainer: diffusion:

trainer: diffusion
job_name: cup_diffusion
train_dataset: /data/datasets/cup_in_the_wild.zarr.zip   # or local@cup_in_the_wild.zarr.zip
batch_size: 64
num_workers: 4
num_epochs: 120
config_name: train_diffusion_unet_timm_umi_workspace
overrides: []        # raw Hydra overrides, applied last
logger:
  type: wandb
  project: umi
solarian train --conf conf/training/<name>

The trainer composes the named UMI workspace config from the vendored diffusion_policy package, applies the overrides above, and runs workspace.run() — the same loop as UMI's train.py.

Cloud (Modal)

Install solarian-modal and run solarian modal-train --conf conf/training/<name> with a modal: block (gpu_type, gpus, volume, ...) in the config. It builds the image from this plugin's modal_spec(), uploads the local dataset the config names, and runs training remotely with accelerate launch.

Serve

solarian-diffusion-policy --input <checkpoint.ckpt> --port 8001

Point any skill (e.g. solarian-skill-cup-arrange) at it via policy_server_url.

License

Apache License 2.0. Copyright 2026 PrimaryKey Inc. The vendored diffusion_policy and umi packages are derived from Universal Manipulation Interface and Diffusion Policy (MIT); see NOTICE.

Solarian and the Solarian logo are trademarks of PrimaryKey Inc. See the trademark policy.

Metadata

Release files for solarian-diffusion 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for solarian-diffusion 0.1.0
File Size Uploaded Provenance Actions
solarian_diffusion-0.1.0.tar.gz 157.5 kB With provenance Details for solarian_diffusion-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for solarian-diffusion 0.1.0
File Interpreter ABI Platform Actions
solarian_diffusion-0.1.0-py3-none-any.whl Python 3 none any Details for solarian_diffusion-0.1.0-py3-none-any.whl

Total release size: 456.4 kB

Release files / solarian_diffusion-0.1.0.tar.gz

Download URL solarian_diffusion-0.1.0.tar.gz
Size 157.5 kB
Tags Source
SHA-256 checksum
How to use checksums
32e9f708a4d716aa059e30dc8fda7e85fb698062e3f6185f8d1138eda08506c7
BLAKE2b-256 checksum
How to use checksums
c5226fdc7d55abd75e24523c966440d6efc04ef21d408d843fc437379df6990c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / solarian_diffusion-0.1.0-py3-none-any.whl

Download URL solarian_diffusion-0.1.0-py3-none-any.whl
Size 298.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e0cfacd9bf1db64ed5bc041af0b74b185ede20fecf491fa5364a3f2395c2095a
BLAKE2b-256 checksum
How to use checksums
96b3fdf996e9b103a0a5cc64b29238acd521fc54de17d8a09078886d2f3eca68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for solarian-diffusion 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for solarian_diffusion-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

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