alt.freeweights.vision / Falcon-Perception
From: tiiuae <huggingface.co/tiiuae>Newsgroups: alt.freeweights.visionSubject:

Falcon-Perception

Date: 2026-11-15Commit: a3e21adSigned: 2DC28CC7B26A283B ✓

Mask generation model with 632M parameters. Safetensors weights, 2.54 GB in all. Published by tiiuae under Apache-2.0.

632M params2.54GBFalcon-Perceptionsafetensorspermissive
FactsParams632MSize2.54 GBFormatssafetensorsTaskmask generationLicenseApache-2.0From sourcepermissive
$ fw get tiiuae/Falcon-Perception
# manifest sha256 b89cfe4c6695… · 2.54 GB · 17 files
$ fw verify ./Falcon-Perception tiiuae/Falcon-Perception
From sourceHosted (signed)tiiuae/Falcon-PerceptionLast check: 2026-11-15 03:28 UTC

Get help: custom fine-tune or private deploy. We review your setup before we quote.

Works with

Runs with

Ranked by fit to this model (safetensors), then by GitHub stars.

Overview

Size
2.54 GB
Weights
2.53 GB (safetensors)
Parameters
632M
Formats
safetensors
Task
mask generation
License
Apache-2.0 (permissive)
Files
17, each with a sha256
Publisher
tiiuae
Added
2026-11-15
Section
alt.freeweights.vision
Lineage

Original release from the publisher.

Where these bytes come from
Publisher at the pinned commit→You

Sources are tried in order. A file counts only when its size and sha256 match the manifest. Sources are checked when you ask for them, not on a timer.

Sources
BadgeHostLast checkResult
From sourcehuggingface.co2026-11-15 03:28 UTCpassed

Model card

From the publisher at commit a3e21ad. Shown as plain text with links; images open at the publisher.

Image: Falcon Perception

Falcon Perception#

Falcon Perception is a 0.6B parameter early-fusion vision-language model for open-vocabulary grounding and instance segmentation. Given an image and a natural language query, it returns zero, one, or many matching instances with pixel-accurate masks.

The model is built around a simple interface. Image patches and text tokens are processed together in a single Transformer using a hybrid attention mask: image tokens build bidirectional visual context, while text and task tokens decode causally conditioned on the image. For each instance, the model generates a short structured sequence of task tokens in a fixed order, <|coord|> then <|size|> then <|seg|>. The <|seg|> token acts as a mask query whose hidden state is projected and dotted with upsampled image features, producing a full-resolution binary mask without autoregressive mask generation.

  • Code and inference engine: https://github.com/tiiuae/Falcon-Perception
  • Tech report: arXiv link coming soon
  • PBench dataset: tiiuae/PBench
  • OCR model: tiiuae/Falcon-OCR

RL post-training for Falcon Perception#

An RL post-trained version of Falcon Perception is available in revision 19-08-2026. It is obtained by reinforcement learning (GRPO) post-training with a simple set-matching reward (a Hungarian-matched count that penalizes false negatives and false positives). This improves recall in high-density scenes (up to 500 instances per image) and removes the need for NMS and coordinate deduplication, at no change to the architecture or tokenizer. For further details read https://arxiv.org/abs/2608.18881.

model = AutoModelForCausalLM.from_pretrained(
    "tiiuae/Falcon-Perception",
    revision="19-08-2026",
    trust_remote_code=True,
    device_map={"": "cuda:0"},
)

Results on PBench (mask F1):

SplitFalcon PerceptionRL post-trainedΔ
L0 Simple objects63.764.9+1.1
L1 Attribute63.864.2+0.5
L2 OCR guided38.340.4+2.1
L3 Spatial understanding53.454.7+1.3
L4 Relation binding49.151.8+2.7
Dense72.380.5+8.2
Average56.859.4+2.6

If you use this version, please cite:

@article{chaybouti2026falcon,
  title={Falcon Perception-HD: High Density Perception via Reinforcement Learning},
  author={Chaybouti, Sofian and Dahou, Yasser and Huynh, Ngoc Dung and Alami, Reda and Kuehne, Hilde},
  journal={arXiv preprint arXiv:2608.18881},
  year={2026}
}

Quickstart#

Installation#
pip install "torch>=2.5" transformers pillow einops pycocotools

This model requires PyTorch 2.5 or newer for FlexAttention. The first call can be slower because torch.compile may build optimized kernels.

Run open-vocabulary segmentation#
import torch
from PIL import Image
from transformers import AutoModelForCausalLM

model = AutoModelForCausalLM.from_pretrained(
    "tiiuae/falcon-perception",
    trust_remote_code=True,
    device_map={"": "cuda:0"},
)

image = Image.open("photo.jpg")
preds = model.generate(image, "cat")[0]

for p in preds:
    print(p["xy"], p["hw"])
Decode masks#
import numpy as np
from pycocotools import mask as mask_utils

for p in preds:
    rle = p["mask_rle"]
    # pycocotools expects bytes for counts
    m = {"size": rle["size"], "counts": rle["counts"].encode("utf-8")}
    mask = mask_utils.decode(m).astype(bool)  # H x W
    print(mask.shape, mask.sum())

API#

model.generate(images, queries, **kwargs)#
ParameterTypeDefaultDescription
imagesPIL.Image or listrequiredSingle image or list of images
queriesstr or list[str]requiredQuery string(s), one per image
max_new_tokensint2048Maximum decoding steps
min_dimensionint256Minimum image side after resize
max_dimensionint1024Maximum image side after resize
compileboolTrueRun torch.compile on first call

Returns: list[list[dict]], one list per image.

Each prediction dict contains:

{
  "xy": {"x": float, "y": float},                    # center in normalized coordinates (0 to 1)
  "hw": {"h": float, "w": float},                    # size in normalized coordinates (0 to 1)
  "mask_rle": {"counts": str, "size": [H, W]},       # COCO RLE at original resolution
}

What the model is for#

Falcon Perception is designed for dense grounding regimes where the main difficulty is localization under open vocabulary. That includes:

  • Natural language driven object selection in images
  • Promptable instance segmentation for downstream pipelines
  • Crowded scenes where the number of instances is large and variable

It is not intended as a general-purpose vision-language assistant for open-ended reasoning, long-form generation, or multi-step VQA.

Model details (high level)#

The architecture follows a single-stack early-fusion recipe:

  • One dense Transformer backbone processes image patches and text tokens in a shared space from the first layer
  • Hybrid attention masking: bidirectional among image tokens, causal for text and task tokens conditioned on the image
  • Chain-of-Perception decoding: <|coord|> then <|size|> then <|seg|> per instance
  • Specialized heads for coordinates and size, with geometry conditioning via Fourier features
  • Parallel mask decoding: each <|seg|> token becomes a mask query and produces a full-resolution mask via dot product with upsampled image features

Evaluation summary#

From the technical report:

  • SA-Co (open-vocabulary segmentation): 68.0 Macro F1 compared to 62.3 for SAM 3, with the main remaining gap being presence calibration (Average MCC 0.64 compared to 0.82 for SAM 3)
  • PBench: a diagnostic benchmark that breaks down performance by capability (attributes, OCR-guided disambiguation, spatial constraints, relations) and includes a dense long-context crowded split

Full tables, setup details, and ablations are in the report.

Limitations#

  • Presence calibration remains a key limitation for autoregressive dense interfaces. False positives are more likely on hard negatives than in DETR like segmentation models.
  • OCR-driven prompts depend on text size and image resolution. Small text and degraded scans are challenging.
  • Dense scenes benefit strongly from high resolution inputs. Low resolution can be sufficient to recognize that a concept is present, but insufficient to localize each instance precisely.

Citation#

If you use Falcon Perception, please cite:

@article{bevli2026falcon,
  title   = {Falcon Perception},
  author  = {Bevli, Aviraj and Chaybouti, Sofian and Dahou, Yasser and Hacid, Hakim and Huynh, Ngoc Dung and Le Khac, Phuc H. and Narayan, Sanath and Para, Wamiq Reyaz and Singh, Ankit},
  journal = {arXiv preprint arXiv:2603.27365},
  year    = {2026},
  url     = {https://arxiv.org/abs/2603.27365}
}

Files

17 files · 2.54 GBWeights 2.53 GB (safetensors). Sizes and sha256 from the signed manifest.
Hide all 17 files with their sha256
FileSizesha256
.eval_results/pbench.yaml198 B1a0f1a96296ddb8581f85a81b8ef029751f6152cb75255ed7a4bceb310e0c911
.gitattributes1.68 KBb06414587db0dcf017755112185bdb650ab75fbbcbcaf43445e388c673e12c59
README.md7.29 KB3c8ed321f56384f2ffc15d3a0ede4c3a56c774542c231de089bda253fae2c45a
Screenshot 2026-04-03 at 8.49.53 PM.png3.89 MB4c63d13f51ae3abe467eeeebd27aa31ab0356c773997028415bbe3531182931b
anyup.py15.9 KB1a150f37dbb8366954b7f62704f250ce92819a115e156b1fe53108ced44f214d
attention.py5.27 KBe7265e33ab3722bc7b001dd33ecfeb59758635eb225a4efa70707a0dcd659b42
config.json1.09 KBa3886840626b9feb1bdb8ba427055914f552f7a68ea0534066c18dc4a4b35e41
configuration_falcon_perception.py2.70 KBad1a0bdc9a2dca98f9657b9ee1f06deca23d80343f61b03f93f93916a44427a3
main_fig.jpg1.48 MBa25a745799ac3cf2967620af6936fa35cb3534b73ff93e42acd37adb67a03c34
model.safetensors2.53 GBc680d5b1a834a2df61baae9dd694b95856872609d0a769702faf5ad658297641
model_args.json823 B1fcfc5d176d6c0c061b9acf0819a399e2d74bcd6d2c3ca99c3655ec6fac862ca
modeling_falcon_perception.py38.8 KB987b371068e6120e5f08458b37dec638d88e1ecb330a6661eeaeba6dd4a27552
processing_falcon_perception.py15.5 KB80ba44e6aa6eaa5f11b335b10fbe62bfcb63bc2b73c7a8fdbe049304b75e5d8d
rope.py4.69 KB8446ee8047a7da4291a9b4b91bbee2e7ca988dc05ab94ce65d9dc12868c345c7
special_tokens_map.json9.16 KB864bc13759c42009e6a60f5ae8a0c533a5975debacad1cb49cf75460f0d6d8fd
tokenizer.json5.06 MB430becbfb4692ab79d1a2b0ba485f3ad16e19012421293c357aac7ad82c522c5
tokenizer_config.json4.06 KB357072b958469e8b6b4cb86fed3399e3c7b56b91ccc4254e6f6627ac7ea70672
VersionsEach time the pinned upstream commit or file list changed in this repo. Newest first.
Upstream commitDateContents
a3e21ada0a pinned now2026-11-15 03:28 UTC17 files · 2.54 GB

Use it

$ fw get tiiuae/Falcon-Perception
# manifest sha256 b89cfe4c6695… · 2.54 GB · 17 files
$ fw verify ./Falcon-Perception tiiuae/Falcon-Perception
fw.pyChecks the signature and every sha256, tries each source in order, resumes.
$ python3 fw.py get https://freeweights.allternit.com/manifests/tiiuae/Falcon-Perception.json --dir ./Falcon-Perception $ python3 fw.py verify ./Falcon-Perception ./tiiuae__Falcon-Perception.json
hfThe Hugging Face CLI with one setting. Same repo id.
$ HF_ENDPOINT=https://freeweights.allternit.com hf download tiiuae/Falcon-Perception --revision a3e21ada0abd533393776ffab8908a728f775509 --local-dir ./Falcon-Perception

License

Name
Apache License 2.0
Id
Apache-2.0
Class
Permissive
Redistribution
yes
Listing
Hosted (signed)
Decided
License as declared by the publisher. No person read it. 2026-11-15
Text in
README.md
Text sha256
3c8ed321f56384f2ffc15d3a0ede4c3a56c774542c231de089bda253fae2c45a
Terms gate
No extra terms beyond the license.

Read the license text

Licenses are checked against the license table. A custom license passes only after a person reads it.

Provenance

From: tiiuae <huggingface.co/tiiuae>Newsgroups: alt.freeweights.visionSubject: Falcon-PerceptionDate: 2026-11-15Commit: a3e21adSigned: 2DC28CC7B26A283B ✓
Upstream
tiiuae/Falcon-Perception
Pinned commit
a3e21ada0abd533393776ffab8908a728f775509
Manifest
Falcon-Perception.json · .minisig
Manifest sha256
b89cfe4c66955d3649b0500e99b1595f29ca3c7db52e1f9c5a61905e4af20e00
Signature
minisign, Ed25519, key 2DC28CC7B26A283B
Created
2026-11-15 03:28 UTC
Generator
freeweights-manifest/0.1.0
Takedowns
None.

How to verify

$ curl -O https://freeweights.allternit.com/manifests/tiiuae/Falcon-Perception.json $ curl -O https://freeweights.allternit.com/manifests/tiiuae/Falcon-Perception.json.minisig $ minisign -Vm Falcon-Perception.json -P RWQ7KGqyx4zCLXtUFOqvfv8L3g+8fpKJ1FsuxPyOYMF+4KufbUxKq1Oq $ shasum -a 256 <file> # compare with the Files tab

A manifest whose signature fails must be rejected. A file whose size or sha256 does not match must be discarded. Verify a download

Model tree

No related models in this catalog.Nothing here lists this model as its parent, and it names no parent.
Get it
Download
$ HF_ENDPOINT=https://freeweights.allternit.com hf download tiiuae/Falcon-Perception
Open in Freeweights Studio

Pull, verify and run it in the Allternit app on Desktop, web or phone.

Signed manifest
minisign, key 2DC28CC7B26A283B. Falcon-Perception.json. Provenance. Takedown history: none.
From: dima806 <huggingface.co/dima806>Subject: ai_vs_real_image_detection
From: legekka <huggingface.co/legekka>Subject: AI-Anime-Image-Detector-ViT
From: onnx-community <huggingface.co/onnx-community>Subject: AI-Anime-Image-Detector-ViT-ONNX
From: AICodexLab <huggingface.co/AICodexLab>Subject: answerdotai-ModernBERT-base-ai-detector
From: onnx-community <huggingface.co/onnx-community>Subject: answerdotai-ModernBERT-base-ai-detector-ONNX
From: onnx-community <huggingface.co/onnx-community>Subject: bart-large-cnn-ONNX