Running DeepSeek Janus Pro 1B on MacOS with ComfyUI

The DeepSeek Janus Pro 1B model represents a significant advancement in the field of multimodal AI, capable of both image understanding and generation. With the integration of this model into ComfyUI, users can harness its capabilities on macOS systems, particularly those equipped with Apple Silicon (M1, M2, or M3 chips).

This comprehensive guide will walk you through the entire process of setting up and running DeepSeek Janus Pro 1B on macOS using ComfyUI, ensuring that you can leverage its powerful features effectively.

Overview of DeepSeek Janus Pro

DeepSeek Janus Pro is a state-of-the-art multimodal model released by DeepSeek on January 27, 2025. It is designed to process and generate images based on textual prompts and vice versa.

The model comes in two versions: Janus Pro 1B and Janus Pro 7B, with the former being optimized for local deployment on consumer hardware.

Key Features

• Multimodal Capabilities: The model can interpret images and generate descriptions or create images based on textual inputs.
• Open Source: As an open-source project, it allows for extensive customization and community contributions.
• Performance: The 1B version is specifically tailored for running efficiently on systems with limited resources.

🚀 Why Choose DeepSeek Janus Pro 1B?

DeepSeek Janus Pro 1B revolutionizes local AI with dual image-text capabilities on consumer hardware. Perfect for developers, artists, and researchers seeking:

• Image-to-Text: Generate detailed captions from photos
• Text-to-Image: Create visuals from descriptive prompts
• Multilingual Support: Output in Japanese, Chinese, and more
• Apple Silicon Optimization: Leverage M-series GPU acceleration

📋 System Requirements & Preparation

Hardware Essentials

Software Stack

• OS: macOS Ventura 13.4+ (Sonoma recommended)
• Python: 3.8-3.10 (Avoid 3.11+ for compatibility)
• Node.js: 18.x LTS (For web UI extensions)
• Homebrew: Latest version
• ComfyUI: Ensure you have the latest version installed.
• Git: For cloning repositories.

🛠️ Installation: Complete Walkthrough

1. Core Environment Setup

# Install Homebrew if missing
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python 3.10 with Pyenv
brew install pyenv
pyenv install 3.10.13
pyenv global 3.10.13

# Verify installation
python --version  # Should show 3.10.13

2. ComfyUI Installation

git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI

# Create isolated virtual environment
python -m venv venv
source venv/bin/activate

# Install with Metal acceleration
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/nightly/cpu
pip install -r requirements.txt

3. Janus Pro Plugin Setup

Method A - Plugin Manager (Recommended):

1. Launch ComfyUI → Click Manager → Install Custom Nodes
2. Search: Janus-Pro → Click Install

Method B - Manual Installation:

cd ComfyUI/custom_nodes
git clone https://github.com/CY-CHENYUE/ComfyUI-Janus-Pro
pip install -r ComfyUI-Janus-Pro/requirements.txt

🔍 Model Installation: Step-by-Step

1. Download Model Files from Hugging Face:
   https://huggingface.co/deepseek-ai/Janus-Pro-1B
2. File Structure Setup:

ComfyUI/
└── models/
    └── Janus-Pro/
        └── Janus-Pro-1B/
            ├── config.json
            ├── pytorch_model.bin
            ├── tokenizer.json
            └── # Other downloaded files

1. Verify Model Detection:
   Launch ComfyUI → Check Checkpoint Loader for "Janus-Pro-1B"

⚡ Performance Optimization Guide

Memory Management Tips

Advanced Configuration

# In ComfyUI/config.yaml
janus_pro:
  device: mps  # Use Metal Performance Shaders
  precision: fp16  # Half-precision mode
  cache_dir: ~/janus_cache  # Speed up subsequent loads

🖼️ Sample Workflow: Image Generation

1. Create New Workflow → Add Nodes:
   • JanusProLoader → Select "Janus-Pro-1B"
   • CLIPTextEncode → Enter prompt: "A cyberpunk cat wearing VR goggles"
   • JanusImageGeneration → Set resolution: 768x512
   • PreviewImage → Connect output
2. Execution Tips:
   • Use Japanese prompts: "出力は日本語で" in text input
   • For complex prompts, enable Advanced Mode → Increase guidance_scale to 7.5

🔧 Troubleshooting Handbook

Common Issues & Solutions

Diagnostic Commands

# Check Metal support
python -c "import torch; print(torch.backends.mps.is_available())"

# Profile VRAM usage
system_profiler SPDisplaysDataType | grep VRAM

📈 Benchmark Results (M2 Max 32GB)

🎓 Pro Tips from AI Engineers

1. Hybrid Workflows: Combine Janus Pro with ControlNet for pose-specific generation
2. API Integration: Use ComfyUI's REST API for batch processing

import requests
response = requests.post('http://localhost:8188/prompt', json={"prompt": workflow_json})

1. Memory Optimization:
   export PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.8 prevents VRAM over-allocation

Troubleshooting Common Issues

While setting up DeepSeek Janus Pro on macOS using ComfyUI may go smoothly for many users, some common issues may arise:

Installation Errors

If you encounter issues during installation:

• Ensure that all dependencies are correctly installed.
• Check that Python is updated to version 3.8 or higher.
• Verify that Git is installed and accessible from your terminal.

Model Loading Issues

If models fail to load:

• Confirm that all required model files are placed in their correct directories.
• Check file permissions to ensure they are readable by your user account.

Performance Issues

If experiencing slow performance:

• Close unnecessary applications to free up RAM.
• Consider upgrading your hardware if consistently running out of resources.

Conclusion

Running DeepSeek Janus Pro 1B on macOS using ComfyUI opens up exciting possibilities in multimodal AI applications. By following this detailed guide, users can successfully install and utilize this powerful tool for both image understanding and generation tasks.

Related Articles

• Run DeepSeek Janus-Pro 7B on Mac: A Comprehensive Guide Using ComfyUI
• Run DeepSeek Janus-Pro 7B on Mac: Step-by-Step Guide
• Run DeepSeek Janus-Pro 7B on Windows: A Complete Installation Guide
• Run DeepSeek Janus Pro 1b on Linux/Ubuntu Using ComfyUI