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
      • Learn
      • Discord
      • Forum
      • GitHub
    • Solutions
      • Team & Enterprise
      • Hugging Face PRO
      • Enterprise Support
      • Inference Providers
      • Inference Endpoints
      • Storage Buckets

  • Log In
  • Sign Up

mlx-community
/
gemma-4-e2b-it-OptiQ-4bit

Text Generation
MLX
Safetensors
gemma4
quantized
mixed-precision
4bit
8bit
optiq
apple-silicon
gemma-4
conversational
4-bit precision
Model card Files Files and versions
xet
Community

Instructions to use mlx-community/gemma-4-e2b-it-OptiQ-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

  • Libraries
  • MLX

    How to use mlx-community/gemma-4-e2b-it-OptiQ-4bit with MLX:

    # Make sure mlx-lm is installed
    # pip install --upgrade mlx-lm
    
    # Generate text with mlx-lm
    from mlx_lm import load, generate
    
    model, tokenizer = load("mlx-community/gemma-4-e2b-it-OptiQ-4bit")
    
    prompt = "Write a story about Einstein"
    messages = [{"role": "user", "content": prompt}]
    prompt = tokenizer.apply_chat_template(
        messages, add_generation_prompt=True
    )
    
    text = generate(model, tokenizer, prompt=prompt, verbose=True)
  • Notebooks
  • Google Colab
  • Kaggle
  • Local Apps Settings
  • LM Studio
  • Pi

    How to use mlx-community/gemma-4-e2b-it-OptiQ-4bit with Pi:

    Start the MLX server
    # Install MLX LM:
    uv tool install mlx-lm
    # Start a local OpenAI-compatible server:
    mlx_lm.server --model "mlx-community/gemma-4-e2b-it-OptiQ-4bit"
    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": "mlx-community/gemma-4-e2b-it-OptiQ-4bit"
            }
          ]
        }
      }
    }
    Run Pi
    # Start Pi in your project directory:
    pi
  • Hermes Agent new

    How to use mlx-community/gemma-4-e2b-it-OptiQ-4bit 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 "mlx-community/gemma-4-e2b-it-OptiQ-4bit"
    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 mlx-community/gemma-4-e2b-it-OptiQ-4bit
    Run Hermes
    hermes
  • MLX LM

    How to use mlx-community/gemma-4-e2b-it-OptiQ-4bit with MLX LM:

    Generate or start a chat session
    # Install MLX LM
    uv tool install mlx-lm
    # Interactive chat REPL
    mlx_lm.chat --model "mlx-community/gemma-4-e2b-it-OptiQ-4bit"
    Run an OpenAI-compatible server
    # Install MLX LM
    uv tool install mlx-lm
    # Start the server
    mlx_lm.server --model "mlx-community/gemma-4-e2b-it-OptiQ-4bit"
    # Calling the OpenAI-compatible server with curl
    curl -X POST "http://localhost:8000/v1/chat/completions" \
       -H "Content-Type: application/json" \
       --data '{
         "model": "mlx-community/gemma-4-e2b-it-OptiQ-4bit",
         "messages": [
           {"role": "user", "content": "Hello"}
         ]
       }'
gemma-4-e2b-it-OptiQ-4bit
5.26 GB
Ctrl+K
Ctrl+K
  • 2 contributors
History: 22 commits
codelion's picture
codelion
card: remove em-dashes, ensure funnel
783acd4 verified about 19 hours ago
  • .gitattributes
    1.57 kB
    Upload folder using huggingface_hub 2 months ago
  • README.md
    5.37 kB
    card: remove em-dashes, ensure funnel about 19 hours ago
  • chat_template.jinja
    17.3 kB
    Fix chat template: emit multimodal placeholders in tool messages 26 days ago
  • config.json
    62.7 kB
    Restore vision_config + optiq_vision marker for image input 8 days ago
  • generation_config.json
    208 Bytes
    Upload folder using huggingface_hub 2 months ago
  • kv_config.json
    982 Bytes
    Add kv_config.json (per-layer mixed-precision KV cache, 5.0 BPW target from OptiQ kv-cache sensitivity analysis). Requires optiq>=0.1.3 runtime for the RotatingQuantizedKVCache shim. 15 days ago
  • model.safetensors
    4.27 GB
    xet
    weights re-quant for mlx-lm 0.31 KV-shared Gemma-4 arch: model.safetensors 22 days ago
  • model.safetensors.index.json
    95.6 kB
    weights re-quant for mlx-lm 0.31 KV-shared Gemma-4 arch: model.safetensors.index.json 22 days ago
  • optiq_metadata.json
    28.8 kB
    weights re-quant for mlx-lm 0.31 KV-shared Gemma-4 arch: optiq_metadata.json 22 days ago
  • optiq_vision.safetensors
    952 MB
    xet
    Add OptIQ vision sidecar (image+text support, v0.2.0) 8 days ago
  • tokenizer.json
    32.2 MB
    xet
    Upload folder using huggingface_hub 2 months ago
  • tokenizer_config.json
    2.74 kB
    Upload folder using huggingface_hub 2 months ago