Run locally / Model details

Imajev-4B

4B text and image model.

Recipe ready · unverifiedtextimage#1 on ImageJevBench (Capability, v0.3.0)

Hardware

Will it run on my machine?

Requirements are recorded per variant. A dash means the catalogue does not provide that value.

VariantPrecisionRuntimeBenchmarkedInstall recipeMinimum / recommended VRAMRAMDiskPlatformsExpected speed
bf16-torch-adapterbf16PyTorch 2.13.0+cu130NoRecipe ready · unverified12 GB / 12 GB16 GB9.83 GBlinux-nvidiaNot measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
bf16-mlx-author-adapterbf16MLXNoRecipe ready · unverifiedUses system/unified RAM / Uses system/unified RAM16 GB9.83 GBmacos-arm64Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
fp32-torch-cpufp32PyTorchNoRecipe ready · unverifiedUses system/unified RAM / Uses system/unified RAM32 GB9.83 GBlinux-cpu, windows-cpuNot measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
fp32-torch-mpsfp32PyTorchNoRecipe ready · unverifiedUses system/unified RAM / Uses system/unified RAM32 GB9.83 GBmacos-arm64Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
bf16-torch-adapterbf16
Runtime
PyTorch 2.13.0+cu130
Install recipe
Recipe ready · unverified
VRAM
12 GB minimum / 12 GB recommended
RAM
16 GB
Disk
9.83 GB
Platforms
linux-nvidia
Expected speed
Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
bf16-mlx-author-adapterbf16
Runtime
MLX
Install recipe
Recipe ready · unverified
VRAM
Uses system/unified RAM minimum / Uses system/unified RAM recommended
RAM
16 GB
Disk
9.83 GB
Platforms
macos-arm64
Expected speed
Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
fp32-torch-cpufp32
Runtime
PyTorch
Install recipe
Recipe ready · unverified
VRAM
Uses system/unified RAM minimum / Uses system/unified RAM recommended
RAM
32 GB
Disk
9.83 GB
Platforms
linux-cpu, windows-cpu
Expected speed
Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
fp32-torch-mpsfp32
Runtime
PyTorch
Install recipe
Recipe ready · unverified
VRAM
Uses system/unified RAM minimum / Uses system/unified RAM recommended
RAM
32 GB
Disk
9.83 GB
Platforms
macos-arm64
Expected speed
Not measured for this installer recipe. Historical published benchmark timings describe a separate runtime.
dm-local plan imajev-4bChecks memory, disk, platform, and runtime against the catalogue.

Quick start

Choose where to run it

Installer commands use the pinned model revision. Confirm the model terms before proceeding.

An install recipe is available, but it has not been verified by an install test.

  1. 1curl -fsSL https://decisionmodels.io/local/install.sh | sh && export PATH="$HOME/.local/bin:$PATH"
  2. 2dm-local install imajev-4b

Call your endpoint

Use a local typed endpoint

The API accepts typed questions and returns typed answers with probabilities.

Request

curl http://127.0.0.1:8484/v1/systemone -H 'Content-Type: application/json' -d '{"state":"Mia owns a red bicycle.","questions":{"color":{"type":"choice","instructions":"Which color is the bicycle?","criteria":{"red":null,"blue":null}}}}'

Example output

{"id":"dec_…","model":"imajev-4b","answers":{"color":{"type":"choice","choice":"red","confidence":0.97,"probabilities":{"red":0.97,"blue":0.03}}},"usage":{"input_tokens":64,"output_tokens":0,"decisions":1}}

Python

import json
import urllib.request
payload = {"state": "Mia owns a red bicycle.",
           "questions": {"color": {"type": "choice", "instructions": "Which color is the bicycle?", "criteria": {"red": None, "blue": None}}}}
request = urllib.request.Request("http://127.0.0.1:8484/v1/systemone", data=json.dumps(payload).encode(), headers={"Content-Type": "application/json"})
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)
print(result["answers"]["color"])

Image input

curl http://127.0.0.1:8484/v1/multimodal -H 'Content-Type: application/json' -d '{"state":"Read the image and answer the question.","images":["data:image/png;base64,…"],"questions":{"object":{"type":"choice","instructions":"What is shown?","criteria":{"bicycle":null,"car":null}}}}'
Read the hosted API reference →

Uninstall

Remove the local files

Use the installer to stop the service and remove this model's downloaded files.

dm-local uninstall imajev-4b

Model terms

Licence details

apache-2.0Commercial use: yes

Commercial use is allowed by the model’s listed licence.

Model card

The local installer has a separate free and commercial licence.

Troubleshooting

Common setup issues

Driver or CUDA version is too old

Update to a driver/runtime combination listed for the selected variant, then run dm-local plan again.

Out of memory

Choose a smaller quantised variant when one is listed, or use a remote GPU with enough recommended memory.

NVIDIA Container Toolkit is missing

Install and configure the NVIDIA Container Toolkit for your host before retrying the container runtime.

The port is already in use

Stop the service using port 8484 or configure a different local port, then rerun the self-test.

A download was interrupted

Run the install command again. Completed downloads resume when the artifact server supports range requests.

Checksum verification failed

Do not use the file. Remove the incomplete download and retry from the pinned official source.

Apple Silicon memory pressure

Close other memory-heavy apps and choose a smaller supported variant if the catalogue lists one.

WSL2 cannot see the GPU

Check the Windows GPU driver and WSL2 GPU support, then verify nvidia-smi inside the WSL distribution.

SSH or firewall blocks the endpoint

Keep the service on loopback and use an SSH tunnel. Avoid exposing the API port directly to the public internet.

Imajev-4B local setup — Decision Models