S-Space README

The project's README from github.com/MirroS-Lab/S-Space. As one markdown file: README.md.

MirroS logo

S-Space

Exploring Spatial Workspace in Multimodal Models

To understand space is to construct it within, to reason is to manipulate what we construct.

arXiv:Paper Blog Code License

Physical space, the S-Space subspace, and spatial coordinate readout

Overview

S-Space is an internal spatial workspace in multimodal models. We identify a three-dimensional linear subspace in intermediate activations that encodes continuous object positions along horizontal, vertical, and distance axes. This representation persists across prompts and multi-view contexts, integrates visual and linguistic information beyond visible objects, and can be causally manipulated to change spatial judgments.

Although models possess rich spatial representations, they do not always use them reliably: explicit computation over S-Space can outperform native reasoning. By examining how this workspace is shaped by supervision, transformed through reasoning, and refined by additional context, we provide a mechanistic perspective on spatial intelligence and a path toward more reliable spatial reasoning and action.

Code lives in sspace/; experiment settings live in configs/.

News

S-Space blog

Get Started

The release includes pretrained S-Space axes and experiment commands for Molmo2-ER, MolmoAct2-Pretrain, MolmoAct2, Qwen3.5-4B and Qwen3.6-27B.

Installation

Use a CUDA host with uv installed; the installation command creates the three model environments and downloads the main models and InstructPart auxiliary models.

git clone https://github.com/Manchery/s-space.git
cd s-space

./scripts/install.sh

Run the remaining commands from this directory. Launchers select the right environment automatically; no manual activation is needed. Environments are stored under .envs/ and model weights under .cache/assets/models/.

Prepare Datasets

Download and prepare COCO, SpatialTunnel, EmbSpatial, CV-Bench, SpinBench and HStar:

./scripts/prepare_data.sh

Downloads are stored under .cache/assets/ and benchmark-ready data under data/processed/. Preparation reuses existing valid files. The MMSI and InstructPart experiment commands below prepare their own data. Experiment results are written under outputs/.

Experiments

After setup, choose an experiment below and copy its command. The repository already includes the required configurations; you do not need to write your own.

Evaluations reuse the released axes in sspace/core/artifacts/pretrained/; rebuilding axes is optional.

Construct S-Space

Learn S-Space axes on COCO-6000 and select readout layers on COCO-1800.

./scripts/run_experiment.sh --experiment sspace-construction

Object Coordinates

Plot the relationship between S-Space coordinates and physical positions using saved COCO projections.

./scripts/plot_object_coordinates.sh

Spatial QA

Compare native answers with S-Space readout on CV-Bench, EmbSpatial and SpatialTunnel.

./scripts/run_experiment.sh --suite benchmarks-generalization \
  --output-root outputs/reproduction/benchmarks

Prompt Generalization

Test whether S-Space readout generalizes across pairwise, single-object and non-spatial prompts.

./scripts/run_experiment.sh --suite prompt-generalization \
  --output-root outputs/reproduction/prompts

Multi-View Reasoning

Test whether S-Space follows the viewpoint specified by the prompt on HStar.

./scripts/run_experiment.sh --suite hstar \
  --output-root outputs/reproduction/multiview

Spatial Interventions

Test whether editing S-Space changes spatial answers while preserving non-spatial judgments on EmbSpatial.

./scripts/run_experiment.sh --experiment spatial-causality

Direction Coupling

Generate Qwen3.6-27B reasoning on MMSI and plot where its direction words lie in S-Space.

./scripts/run_experiment.sh --experiment direction-coupling

Action Supervision

Compare part–whole spatial judgments across Molmo2-ER, MolmoAct2-Pretrain and MolmoAct2 on InstructPart.

./scripts/run_experiment.sh --experiment action_supervision

Perspective Taking

Compare direct and chain-of-thought answers with S-Space readout and rotation on SpinBench, with and without the premise.

./scripts/run_experiment.sh --suite spinbench-direct \
  --output-root outputs/reproduction/spinbench-native

./scripts/run_experiment.sh --suite spinbench-projection \
  --output-root outputs/reproduction/spinbench-sspace

CoT Evolution

Track how Qwen3.6-27B's spatial representations change across a supplied, gold-conditioned reasoning template on SpinBench.

./scripts/run_experiment.sh --experiment cot-evolution

Context Scaling

Measure how adding the premise changes layerwise S-Space readout accuracy on SpinBench.

./scripts/run_experiment.sh --experiment context-scaling

License

This project is licensed under the Apache License 2.0.

Acknowledgements

Component Projects
Models MolmoAct2, Qwen
Benchmarks SpatialTunnel, EmbSpatial-Bench, CV-Bench, HStar, SpinBench
Training data COCO

Citation

If you find S-Space useful, please cite:

@misc{mirros2026sspace,
    title  = {S-Space: Exploring Spatial Workspace in Multimodal Models},
    author = {{MirroS Team}},
    year   = {2026},
    month  = {September},
    url    = {https://mirros.ai/blog/s-space},
    note   = {Blog post}
}

S-Space (MirroS-Lab/S-Space)

Searching Database…

这是什么?S-Space 是一个研究项目,它在多模态模型的激活值内部找到了一个三维线性子空间,编码物体沿水平、垂直和距离轴的位置,并证明这个子空间可以被读取出来,甚至可以通过因果干预来改变模型的空间判断。
它是现成的工具,还是一堆研究实验脚本?它是一个用于复现实验的研究代码库:核心探测/分析代码在 sspace/ 里,每个实验的配置在 configs/ 里,通过运行命令来使用,而不是可安装的应用。
怎么让它跑起来?你需要一台装有 uv 的 CUDA 机器;一条安装命令即可建好三个独立的模型环境,并自动下载主模型和 InstructPart 辅助模型。
跑实验之前需要先下载什么?大多数实验之前,你必须先下载并准备多个基准数据集(COCO、SpatialTunnel、EmbSpatial、CV-Bench、SpinBench 和 HStar);MMSI 和 InstructPart 等部分实验会另行获取各自的数据,准备过程会复用已下载的有效文件。
模型内部的 S-Space 到底是什么?它是在中间激活值中发现的三维线性子空间,编码物体的水平、垂直和距离位置;它在不同提示和多个视角下都稳定存在,并整合了视觉和语言线索。
它适用于哪些模型和基准?该发布涵盖 Molmo2-ER、MolmoAct2-Pretrain、MolmoAct2、Qwen3.5-4B 和 Qwen3.6-27B,在 COCO、SpatialTunnel、EmbSpatial、CV-Bench、SpinBench 和 HStar 等数据集上评估。
为什么要构建 S-Space,而不是直接相信模型自己的推理?作者发现模型内部拥有丰富的空间表征,但不总能可靠地使用它们,因此直接读取 S-Space 的效果可能优于模型原生的思维链空间推理。
开箱即用能跑哪些实验?现成的实验包括:构建 S-Space 各坐标轴、空间问答对比、多视角推理、因果空间干预、有无前提的视角采择,以及追踪思维链推理如何重塑表征。
Creator
MirroS-Lab
Size
14 MB
Stars
174
Updated
CommitOct 13
Age
1mo
Commits · 90 Days