git404hub

what is cortex fr?

internrobotics/cortex — explained in plain English

Analysis updated 2026-05-18

45PythonAudience · researcherComplexity · 5/5Setup · hard

tl;dr

A research framework that splits robot control between a planning AI and an execution AI so a robot can complete long, multi-step physical tasks.

vibe map

mindmap
  root((Cortex))
    What It Does
      Plans long tasks
      Executes robot actions
      Tracks memory
    Tech Stack
      Python
      PyTorch
      Hugging Face
    Use Cases
      Robot benchmarks
      Data annotation
      Zero-shot planning
    Audience
      Researchers
      Robotics teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Evaluate a robot planning model on long-horizon manipulation benchmarks like RoboTwin.

VIBE 2

Download the released Cortex model to test zero-shot long-horizon task planning.

VIBE 3

Use the three-stage annotation workflow to label subtasks in a new robot dataset.

VIBE 4

Run closed-loop episode evaluation to measure how well a plan holds up across a full task.

what's the stack?

PythonPyTorchHugging FaceSlurm

how it stacks up fr

internrobotics/cortexazureshores/bitcrusherdeepexperience/hypereyes
Stars454545
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity5/52/55/5
Audienceresearchergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1day+

Requires cluster access with sbatch, downloaded model checkpoints, and GPU resources for evaluation.

in plain english

Cortex is a research framework for controlling robots that need to complete long, multi-step physical tasks, such as a sequence of chemistry-style lab actions rather than a single quick motion. It also goes by the name InternVLA-M1.5. The core idea is to split the work between two AI models that stay aligned with each other. A higher-level model acts like a planner: it watches the scene, keeps track of what has already happened using a running memory, and breaks the overall goal into smaller subtasks. A lower-level model then handles the physical execution of each subtask, reacting moment to moment to actually move the robot. The project provides three main things. First, a large dataset of over 4,000 hours of annotated long-horizon subtask examples, pulled from multiple existing robot datasets and benchmarks. Second, an automated three-stage workflow for labeling this kind of data: an AI model generates first-pass labels, a person corrects a small sample of these in a browser, and the corrections are then spread across the rest of the data automatically. Third, a ready-to-download planning model that can be used directly for zero-shot long-horizon planning, meaning it can plan for new tasks it was not specifically trained on. The README reports that Cortex outperforms comparison models on internal benchmarks, including general-purpose systems like GPT-5 and Gemini, on tasks involving spatial reasoning, counting, and multi-step logical consistency. It also reports stronger results on simulated benchmarks and, notably, a large jump in success rate on real-world manipulation tasks compared to a prior method. Using Cortex requires following a setup guide before running any evaluation, and the examples in the README involve setting environment variables, downloading a released model checkpoint from Hugging Face, and submitting evaluation jobs through a cluster scheduler called sbatch. There are separate evaluation modes for testing individual steps versus testing a full closed loop across an entire task, plus a visualization script for reviewing subtask predictions. The README also documents how to set up API credentials for the labeling workflow, with a note to keep them in the shell environment rather than in any script or committed file. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Walk me through how Cortex splits planning and execution between two models.
prompt 2
Help me set up the environment needed to run Cortex's step-level evaluation.
prompt 3
Explain what the three-stage subtask annotation workflow in Cortex does.
prompt 4
Summarize how Cortex's real-world manipulation results compare to the pi05 baseline.

Frequently asked questions

what is cortex fr?

A research framework that splits robot control between a planning AI and an execution AI so a robot can complete long, multi-step physical tasks.

What language is cortex written in?

Mainly Python. The stack also includes Python, PyTorch, Hugging Face.

How hard is cortex to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is cortex for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.