Hugging Face's logo Hugging Face
  • Models
  • Datasets
  • Spaces
  • Buckets new
  • Docs
  • Enterprise
  • Pricing
    • Website
      • Tasks
      • HuggingChat
      • Collections
      • Languages
      • Organizations
    • Community
      • Blog
      • Posts
      • Daily Papers
      • Hardware
      • Learn
      • Discord
      • Forum
      • GitHub
    • Solutions
      • Team & Enterprise
      • Hugging Face PRO
      • Enterprise Support
      • Inference Providers
      • Inference Endpoints
      • Storage Buckets

  • Log In
  • Sign Up

OsaurusAI
/
LFM2.5-VL-3B-MXFP8

Image-Text-to-Text
MLX
Safetensors
English
Chinese
Arabic
lfm2_vl
vmlx-swift
osaurus
jang
liquid
lfm2.5
vision-language
multimodal
conversational
custom_code
8-bit precision
Model card Files Files and versions
xet
Community

Instructions to use OsaurusAI/LFM2.5-VL-3B-MXFP8 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

  • Libraries
  • MLX

    How to use OsaurusAI/LFM2.5-VL-3B-MXFP8 with MLX:

    # Make sure mlx-vlm is installed
    # pip install --upgrade mlx-vlm
    
    from mlx_vlm import load, generate
    from mlx_vlm.prompt_utils import apply_chat_template
    from mlx_vlm.utils import load_config
    
    # Load the model
    model, processor = load("OsaurusAI/LFM2.5-VL-3B-MXFP8")
    config = load_config("OsaurusAI/LFM2.5-VL-3B-MXFP8")
    
    # Prepare input
    image = ["http://images.cocodataset.org/val2017/000000039769.jpg"]
    prompt = "Describe this image."
    
    # Apply chat template
    formatted_prompt = apply_chat_template(
        processor, config, prompt, num_images=1
    )
    
    # Generate output
    output = generate(model, processor, formatted_prompt, image)
    print(output)
  • Notebooks
  • Google Colab
  • Kaggle
  • Local Apps Settings
  • LM Studio
  • Pi

    How to use OsaurusAI/LFM2.5-VL-3B-MXFP8 with Pi:

    Start the MLX server
    # Install MLX LM:
    uv tool install mlx-lm
    # Start a local OpenAI-compatible server:
    mlx_lm.server --model "OsaurusAI/LFM2.5-VL-3B-MXFP8"
    Configure the model in Pi
    # Install Pi:
    npm install -g @mariozechner/pi-coding-agent
    # Add to ~/.pi/agent/models.json:
    {
      "providers": {
        "mlx-lm": {
          "baseUrl": "http://localhost:8080/v1",
          "api": "openai-completions",
          "apiKey": "none",
          "models": [
            {
              "id": "OsaurusAI/LFM2.5-VL-3B-MXFP8"
            }
          ]
        }
      }
    }
    Run Pi
    # Start Pi in your project directory:
    pi
  • OpenClaw new

    How to use OsaurusAI/LFM2.5-VL-3B-MXFP8 with OpenClaw:

    Start the MLX server
    # Install MLX LM:
    uv tool install mlx-lm
    # Start a local OpenAI-compatible server:
    mlx_lm.server --model "OsaurusAI/LFM2.5-VL-3B-MXFP8"
    Configure OpenClaw
    # Install OpenClaw:
    npm install -g openclaw@latest
    # Register the local server and set it as the default model:
    openclaw onboard --non-interactive --mode local \
      --auth-choice custom-api-key \
      --custom-base-url http://127.0.0.1:8080/v1 \
      --custom-model-id "OsaurusAI/LFM2.5-VL-3B-MXFP8" \
      --custom-provider-id mlx-lm \
      --custom-compatibility openai \
      --custom-text-input \
      --accept-risk \
      --skip-health
    Run OpenClaw
    openclaw agent --local --agent main --message "Hello from Hugging Face"
  • Hermes Agent

    How to use OsaurusAI/LFM2.5-VL-3B-MXFP8 with Hermes Agent:

    Start the MLX server
    # Install MLX LM:
    uv tool install mlx-lm
    # Start a local OpenAI-compatible server:
    mlx_lm.server --model "OsaurusAI/LFM2.5-VL-3B-MXFP8"
    Configure Hermes
    # Install Hermes:
    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
    hermes setup
    # Point Hermes at the local server:
    hermes config set model.provider custom
    hermes config set model.base_url http://127.0.0.1:8080/v1
    hermes config set model.default OsaurusAI/LFM2.5-VL-3B-MXFP8
    Run Hermes
    hermes
  • Atomic Chat
LFM2.5-VL-3B-MXFP8
3.65 GB
Ctrl+K
Ctrl+K
  • 1 contributor
History: 2 commits
Osaurus-AI's picture
Osaurus-AI
Add files using upload-large-folder tool
0229cf4 verified about 18 hours ago
  • .gitattributes
    1.57 kB
    Add files using upload-large-folder tool about 18 hours ago
  • README.md
    4.82 kB
    Add files using upload-large-folder tool about 18 hours ago
  • chat_template.jinja
    5.49 kB
    Add files using upload-large-folder tool about 18 hours ago
  • config.json
    6.21 kB
    Add files using upload-large-folder tool about 18 hours ago
  • generation_config.json
    343 Bytes
    Add files using upload-large-folder tool about 18 hours ago
  • jang_config.json
    1.62 kB
    Add files using upload-large-folder tool about 18 hours ago
  • model.safetensors
    3.63 GB
    xet
    Add files using upload-large-folder tool about 18 hours ago
  • model.safetensors.index.json
    72.9 kB
    Add files using upload-large-folder tool about 18 hours ago
  • osaurus-x-banner.png
    26.3 kB
    Add files using upload-large-folder tool about 18 hours ago
  • processor_config.json
    815 Bytes
    Add files using upload-large-folder tool about 18 hours ago
  • tokenizer.json
    17.9 MB
    xet
    Add files using upload-large-folder tool about 18 hours ago
  • tokenizer_config.json
    540 Bytes
    Add files using upload-large-folder tool about 18 hours ago