---
language:
  - en
license: other
license_name: nimbus-layered-open-source
license_link: https://huggingface.co/Nimbus-Labs/Nimbus-2B/blob/main/LICENSES.md
library_name: transformers
pipeline_tag: image-text-to-text
base_model: Qwen/Qwen3.5-2B-Base
base_model_relation: finetune
tags:
  - nimbus
  - qwen3.5
  - coding
  - reasoning
  - local
  - transformers
---

![Nimbus Labs local coding models](assets/nimbus-labs-social.svg)

# Nimbus-2B

A fast local coding assistant built for low-latency drafting, repair, and focused repository tasks.

Nimbus is a family of local coding models: **2B for speed, 4B for balance, and 9B v2.1 for deeper reasoning**. This Transformers repository contains the merged BF16 checkpoint and full multimodal components. The corresponding GGUF repository is text-only.

## Choose a Nimbus model

| Model | Best fit | Transformers | GGUF | MLX |
| --- | --- | --- | --- | --- |
| Nimbus-2B | Fast drafting and focused edits | [`Nimbus-Labs/Nimbus-2B`](https://huggingface.co/Nimbus-Labs/Nimbus-2B) | [`Nimbus-Labs/Nimbus-2B-GGUF`](https://huggingface.co/Nimbus-Labs/Nimbus-2B-GGUF) | [`Nimbus-Labs/Nimbus-2B-MLX-5bit`](https://huggingface.co/Nimbus-Labs/Nimbus-2B-MLX-5bit) |
| Nimbus-4B | Balanced implementation and debugging | [`Nimbus-Labs/Nimbus-4B`](https://huggingface.co/Nimbus-Labs/Nimbus-4B) | [`Nimbus-Labs/Nimbus-4B-GGUF`](https://huggingface.co/Nimbus-Labs/Nimbus-4B-GGUF) | [`Nimbus-Labs/Nimbus-4B-MLX-5bit`](https://huggingface.co/Nimbus-Labs/Nimbus-4B-MLX-5bit) |
| Nimbus-9B v2.1 | Deeper coding and reasoning | [`Nimbus-Labs/Nimbus-9B-v2.1`](https://huggingface.co/Nimbus-Labs/Nimbus-9B-v2.1) | [`Nimbus-Labs/Nimbus-9B-v2.1-GGUF`](https://huggingface.co/Nimbus-Labs/Nimbus-9B-v2.1-GGUF) | [`Nimbus-Labs/Nimbus-9B-v2.1-MLX-5bit`](https://huggingface.co/Nimbus-Labs/Nimbus-9B-v2.1-MLX-5bit) |

![Nimbus family download footprint](assets/nimbus-family-footprint.png)

The adjacent `assets/nimbus-family-footprint.json` contains the plotted values. Download size is not runtime memory: context cache and runtime buffers require additional capacity.


## Artifacts

| Format | Shards | Weight bytes | Integrity |
| --- | ---: | ---: | --- |
| BF16 safetensors | 3 | 4,426,558,168 (4.43 GB) | `SHA256SUMS` |

Text-only local files: [`Nimbus-Labs/Nimbus-2B-GGUF`](https://huggingface.co/Nimbus-Labs/Nimbus-2B-GGUF)

## Evaluation

No public score is claimed in this card yet. Results will be added only after the exact released artifact, complete task set, and scorer outputs are bound to a release manifest.



## Quickstart

Use a recent Transformers release compatible with Qwen3.5. Load the repository with `trust_remote_code=False`, preserve the supplied processor/tokenizer files, and enable thinking through the supplied chat template where supported. Validate generated code before execution.

```python
from transformers import AutoProcessor, AutoModelForImageTextToText

model_id = "Nimbus-Labs/Nimbus-2B"
processor = AutoProcessor.from_pretrained(model_id)
model = AutoModelForImageTextToText.from_pretrained(model_id, torch_dtype="auto", device_map="auto")
```

## Training and provenance

- Immediate upstream: [`Qwen/Qwen3.5-2B-Base`](https://huggingface.co/Qwen/Qwen3.5-2B-Base)
- Pinned revision: `b1485b2fa6dfa1287294f269f5fb618e03d52d7c`
- Foundation: Qwen3.5
- Relationship: Nimbus post-training / fine-tune and verified merge
- Exact uploaded file hashes: `SHA256SUMS`
- Release metadata: `release-manifest.json`

Nimbus prominently credits Qwen3.5 as the foundation for this model family. Nimbus-9B-v2.1 additionally credits DeepReinforce's Ornith-1.0-9B as its immediate upstream.

## Intended use

Local coding assistance, code explanation, debugging, test generation, and bounded tool-aware workflows. Host applications must enforce permissions, sandboxing, timeouts, and verification.

## Limitations

The model can produce incorrect, insecure, incomplete, or non-compiling code. Benchmark performance does not guarantee project-level correctness. GGUF artifacts are text-only even though this Transformers checkpoint includes multimodal components.

## Licenses and notices

See [`LICENSES.md`](LICENSES.md), [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md), and the bundled Apache-2.0 text. The model is a derivative distribution; Nimbus attribution does not replace upstream attribution.

## Project

[Nimbus8](https://nimbus8.app) · [GGUF files](https://huggingface.co/Nimbus-Labs/Nimbus-2B-GGUF)