Valen README

The project's README from github.com/Liuziyu77/Valen. As one markdown file: README.md.

Valen — a teal aperture with a forward arrow and uppercase wordmark
System One Model, now with vision.

A multimodal decision model inspired by Jev — text, images and video in; decision probabilities out.

Hugging Face: Valen Team License: Apache 2.0 Python 3.10+ SFT and experimental RLCD
Model: Valen-Preview-0923 Try Valen on Hugging Face Spaces Training dataset: Valen-Training-General-100k Evaluation dataset: Valen-Eval-General-5k Evaluation dataset: Valen-Eval-Game

English · 简体中文
Intro · Demos · Model downloads · Eval results · Quick start

✨ Introduction

Valen (万澜) brings visual perception to System One decision-making. Inspired by Jev, it evaluates text, images and video against task instructions and returns probabilities over supplied candidates, giving software a structured decision interface. A Qwen3.5-0.8B or 2B backbone and a shared decision head score candidates without generating answer tokens. The repository includes the model implementation, data processing, SFT and experimental RLCD training, and inference and evaluation commands, with support for training on your own data.

🎬 Demos

Try Valen-Preview-0923 in the online demo.

Against a 27B generation model

Valen-Preview-0923 reads the board image and selects a movement direction at each step. On the same level, Valen-Preview-0923 solves the puzzle in 9 decisions with 1.13 seconds of cumulative decision latency. Qwen3.8-27B-FP8 takes 198.05 seconds in thinking mode and fails to solve it in no-thinking mode.

Side-by-side Sokoban demo comparing Valen-Preview-0923 with Qwen3.8-27B-FP8 in no-thinking and thinking modes.

Image blur and action confidence

Gaussian blur reveals how Valen-Preview-0923 adapts its decisions and confidence as visual detail decreases. Decision confidence is 91.6% on the clear image and 19.2% at the strongest blur.

Valen-Preview-0923 action probabilities and decision confidence across nine measured levels of Gaussian image blur.

Four games in parallel

Four successful Valen-Preview-0923 trajectories run side by side at 1× speed with no playback acceleration. Each game takes 7–10 decisions, averaging 122–128 ms per step, and all four finish within 1.24 seconds.

Four successful Valen-Preview-0923 games replayed in parallel at recorded speed.

📥 Model downloads

Running Valen requires both the Valen checkpoint and the Qwen3.5-2B base model.

Model Role Download
Valen-Preview-0923 Valen checkpoint 🤗 Hugging Face

Datasets: General 100k training · General 5k evaluation · Sokoban training and evaluation.

📊 Evaluation results

Lower latency, higher accuracy. Four panels compare General accuracy, General latency, Sokoban accuracy and Sokoban latency, from left to right. Each panel shows Qwen3.5-0.8B, Qwen3.5-2B and a Valen 2B RL checkpoint. General uses 5,000 questions from multiple VQA datasets; Sokoban uses 500 single-step questions from 100 levels.

Four panels comparing Qwen3.5-0.8B, Qwen3.5-2B and Valen on General and Sokoban accuracy and mean end-to-end latency. General uses the General-trained RL checkpoint; Sokoban uses Valen-Preview-0923.

See the technical notes for training data, the Model Card and loss curves.

🚀 Quick start

Install the dependencies listed in requirements, then download both the Preview checkpoint and its Qwen3.5-2B base model.

# Download the Valen-Preview-0923 checkpoint.
hf download Valen-Team/Valen-Preview-0923 --local-dir models/Valen-Preview-0923

# Download the Qwen3.5-2B base model.
hf download Qwen/Qwen3.5-2B --local-dir models/Qwen3.5-2B

# Train the model with your own configuration.
python -m valen.train \
  --config configs/train/qwen/sft_warmup.json

# Run inference with the downloaded Valen-Preview-0923 checkpoint.
python -m valen.inference \
  --checkpoint models/Valen-Preview-0923 \
  --data data/smoke/train.jsonl \
  --output output/sft_warmup/predictions.jsonl

# Check the evaluation pipeline on the same synthetic examples.
python -m valen.evaluate \
  --checkpoint models/Valen-Preview-0923 \
  --data data/smoke/train.jsonl \
  --output output/sft_warmup/smoke_eval

data/smoke contains a small set of simple questions for checking that the pipeline runs correctly.

A labeled record with an image input

Each JSONL line contains one record. The example below uses the evaluation overview figure from the repository, assuming the file is saved as example.jsonl in the repository root.

{
  "group_id": "evaluation-general-2b",
  "request": {
    "state": {
      "messages": [{
        "role": "user",
        "content": [
          {"type": "text", "text": "Compare the accuracy and the average latency per question of the 2B models on General in the figure."},
          {"type": "image_url", "image_url": {"url": "assets/figures/evaluation-results.png"}}
        ]
      }]
    },
    "questions": {
      "best_2b": {
        "type": "choice",
        "instructions": "On General, among the 2B models with average latency below 200 ms per question, which has the highest accuracy?",
        "criteria": {
          "qwen": "Qwen3.5-2B",
          "valen": "Valen-Preview-0923"
        }
      }
    }
  },
  "targets": {
    "best_2b": {"probabilities": {"qwen": 0.0, "valen": 1.0}}
  }
}

🤝 Contributions

Contributions to Valen are welcome. Open an issue to report a problem, share a use case or discuss experimental results. Submit a pull request to improve the code or documentation, contribute training data or add evaluation tasks.

Scan the QR code below to join the Valen WeChat group, discuss the project and share your experiments.

QR code for the Valen WeChat discussion group

📄 License and acknowledgments

The code is released under Apache 2.0. Base models and source datasets retain their respective licenses.

Built on Qwen3.5, with the decision interface inspired by TypeSafe's Jev.

Valen (Liuziyu77/Valen)

Searching Database…

861 ·GitHub
这是什么?Valen(万澜)是一个多模态决策模型,为“系统一”式的决策添加视觉感知:它使用任务指令,针对文本、图像和视频给候选动作打分,而不是生成自由格式的回答。
这是一个可以对话的聊天机器人,还是别的东西?它不是聊天机器人,而是一个决策打分模型:Qwen3.5-0.8B 或 2B 骨干网络加上一个共享的决策头,对固定的候选集合输出概率,而不生成回答 token。
怎么把它跑起来?安装 requirements 里的依赖,然后从 Hugging Face 下载 Valen-Preview-0923 检查点和与之匹配的 Qwen3.5-2B 基座模型。data/smoke 文件夹里有一小套测试问题,可以验证整个流程能正常工作。
我也需要 Qwen3.5 基座模型,还是只要 Valen 检查点?两者都要。运行 Valen 需要 Valen 检查点加上配套的 Qwen3.5-2B 基座模型,两者都要从 Hugging Face 单独下载。
RL 训练阶段是已经完成,还是仍处于实验阶段?SFT 训练是主要的成熟路径,而 RLCD(强化学习)训练阶段被明确描述为实验性的。
代码和模型可以随意使用吗?Valen 代码本身采用 Apache 2.0,但基座模型(Qwen3.5)和源数据集仍保留它们各自原本的许可证。
为什么 Valen 能在这些任务上胜过体量大得多的 27B 模型?Valen 通过决策头直接给预定义的候选打分,而不是生成推理文本,因此它用 9 次决策、总计 1.13 秒解开了谜题,而 Qwen3.5-27B-FP8 模型在思考模式下花了 198 秒,在无思考模式下依然失败。
什么是“系统一”决策?它指的是快速、直觉式的决策,而不是一步步的深思推理。Valen 直接返回候选概率,而不是在回答前先生成思维链文本,正是这一理念的体现。
有哪些可用的训练和评估数据?该项目提供了 General 100k 训练集、从多个 VQA 数据集中抽取的 General 5k 评估集,以及 Sokoban 训练/评估数据,涵盖来自 100 个推箱子关卡的 500 道单步问题。
图像模糊会怎样影响模型的置信度?决策置信度从清晰图像下的 91.6% 降到最强高斯模糊下的 19.2%,说明 Valen 会随着视觉细节的减少调整自身的确定性。
Creator
Liuziyu77
Size
70.8 MB
Stars
861
Updated
CommitOct 16
Age
25d
Commits · 90 Days