Open Source RoboticsRobots, software & field notes

Octo

Based on published sources · Not tested by us ·

Overview

Transformer diffusion robot policies with pretrained checkpoints and fine-tuning tools; observation history, action statistics and robot-specific interfaces must match the selected model. [S001]

Octo is a family of transformer diffusion policies with code for training, fine-tuning and evaluation. The reviewed source is v1.5. This entry also inspects the separately hosted Octo Base 1.5 model card, which describes a 93-million-parameter model trained on a mixture of Open X-Embodiment datasets. Code and checkpoint revisions are separate parts of the evidence. [S001] [S002] [S008]

Specifications

DetailDescription
Intended usersRobot-learning researchers with a compatible environment and accelerator setup
Editorial assessment [S001] · Checked 2026-10-01
Required softwarePython 3.10 in upstream environment instructions; JAX 0.4.20 with CUDA11 or TPU installation route; Checkpoint and robot/dataset-specific normalization statistics; Separate robot or Gym-compatible evaluation environment
Reported by source [S001] [S005] [S006] · Checked 2026-10-01
InstallationFollow the pinned Python/JAX environment instructions, choose a versioned checkpoint and run the documented debug fine-tuning or offline inference example before integrating an environment.
Editorial sequence; neither installation nor inference performed.
Editorial assessment [S001] [S005] · Checked 2026-10-01
UsesLoad pretrained checkpoints; Run offline inference with matched dataset statistics; Fine-tune for new observations and action spaces; Evaluate through an environment adapter
Reported by source [S001] [S005] [S006] · Checked 2026-10-01
File formatsNot known
Development statusDocumented setup available
Research classification from documented artifacts/workflow, not our reproduction or production qualification.
Editorial assessment [S001] · Checked 2026-10-01

3D preview

A robot-part preview is not applicable to this software project profile.

Installation and use

Select a versioned checkpoint

The source overview's quick-start example loads octo-base-1.5, while its checkpoint table links to unversioned Base and Small model names. The inference notebook uses Small 1.5. Record the exact model repository and revision used in an experiment rather than relying on the family name. The model card inspected here is for Base 1.5; its dimensions should not be assumed to describe a subsequently fine-tuned model. [S001] [S005] [S008]

Upstream's installation route uses Python 3.10 and JAX 0.4.20, with separate CUDA11 and TPU commands. Its initial debug fine-tuning command loads Small 1.5. Those pinned instructions need a compatible accelerator environment; this review did not install or execute them. The reported pretraining route is much larger: upstream describes approximately 1.2 TB of prepared data and TPU-pod training. An inference example does not reproduce that training process. [S001]

Match observations and history

Base 1.5's model card describes primary RGB images at 256 by 256 and wrist images at 128 by 128, with batch and history dimensions. It allows subsets of the listed observation and task keys and a history window of up to two timesteps. The environment adapter guide requires observation keys to match the keys used in the training configuration; absent keys are padded. [S006] [S008]

History padding is a different concern from a missing camera. The README explains that timestep_pad_mask marks which history timesteps exist, including the absent previous observation at the start of a trajectory. The per-modality mask handles missing observation elements. Using these mechanisms deliberately avoids presenting missing information as a real measurement. [S001]

The offline notebook adds batch and history dimensions explicitly, creates a language task through the model helper and samples an action chunk. It also passes action unnormalization statistics for the Bridge dataset. Those statistics belong to that example's data conventions; copying them into an unrelated robot integration does not establish the correct physical action interpretation. [S005]

An action chunk is not a complete plan

Base 1.5 predicts four seven-dimensional actions at a time. The README offers several execution choices: execute the chunk, execute only its first action before resampling, or use temporal ensembling. None of these turns a single output into a full task trajectory. Choose the action execution scheme together with the robot interface and evaluation configuration. [S001] [S008]

The fine-tuned ALOHA simulation example uses its own environment, checkpoint, normalization statistics and history/action wrappers. It also specifies separate simulator dependencies and an external ACT checkout. It is evidence of an integration example, not a universal adapter or proof of performance on another robot. No rollout, real-robot trial or inference-speed measurement was performed for this profile. [S007]

Model rights do not settle dataset rights

The source repository carries an MIT license, and the inspected Base1.5 model card separately reports MIT. The training mixture comprises multiple datasets, and the source links to their collection and preparation tooling. This review has not verified each constituent dataset's terms or downloaded the checkpoint and dataset payloads. It therefore makes no blanket licensing or complete reproduction claim for the training corpus. [S001] [S003] [S008]

Source files and licenses

Available project sources support research coverage; complete build and commercial qualification remain separate.

LayerAvailability / license
softwareavailable · MIT
[S003]
model weightsavailable · MIT
Pinned Base1.5 model card reports MIT. Checkpoint payload not downloaded or executed; this finding is scoped to this model-card revision. [S001] [S008]
datasetsavailable · License not fully assessed
Upstream links the Open X-Embodiment collection and preparation script. Constituent dataset licenses and payloads were not individually verified; no uniform dataset license asserted. [S001] [S008]
documentationavailable · License not fully assessed
Examples and source documentation available; separate documentation-wide license not established. [S001] [S004] [S005]

References

Links identify the documentation and revisions used in this profile. Access dates record when each source was retrieved.

  1. S001 · octo-models / project contributors
    Upstream project overview
    Accessed 2026-10-01 · README.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  2. S002 · octo-models / project contributors
    Repository revision and release metadata
    Accessed 2026-10-01 · 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  3. S003 · octo-models / project contributors
    Repository license
    Accessed 2026-10-01 · LICENSE
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  4. S004 · octo-models / project contributors
    Pinned repository artifact inventory
    Accessed 2026-10-01 · 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b archive file inventory
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  5. S005 · octo-models / project contributors
    Octo v1.5: examples/01_inference_pretrained.ipynb
    Accessed 2026-10-01 · 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b / examples/01_inference_pretrained.ipynb
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  6. S006 · octo-models / project contributors
    Octo v1.5: examples/envs/README.md
    Accessed 2026-10-01 · 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b / examples/envs/README.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  7. S007 · octo-models / project contributors
    Octo v1.5: examples/03_eval_finetuned.py
    Accessed 2026-10-01 · 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b / examples/03_eval_finetuned.py
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  8. S008 · octo-models / project contributors
    Octo Base 1.5 checkpoint model card
    Accessed 2026-10-01 · ee3c10e8edd6ce2e8b1e8744d3c6fba4097bed48 / README.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

Research and review details

Source research only; no installation, physical build or performance test performed. No affiliate links added.

Profile edited 2026-10-01 · Sources checked 2026-10-01 · Next review target 2026-10-31

Revision: 5eaa5c6960398925ae6f52ed072d843d2f3ecb0b (release v1.5). Software repository activity recorded 2024-05-23 [S002]

Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1

Change history