DeepHermes

Run DeepHermes 3 on macOS: Step by Step Installation Guide

Anas Mohammad

Feb 14, 2025 • 7 min read

DeepHermes 3 is a powerful language model that integrates reasoning capabilities with traditional language processing. This makes it an attractive tool for various applications, especially for users who want to leverage its capabilities on their macOS devices.

This article provides a detailed guide on how to run DeepHermes 3 on macOS, covering prerequisites, installation, setup, and troubleshooting.

Prerequisites and System Requirements

Before you begin, ensure your macOS system meets the necessary prerequisites and system requirements. These typically include:

Hardware Requirements:

A Mac computer with an Apple Silicon chip (M1, M2, or M3) or an Intel processor.
Sufficient RAM (16GB or more recommended) for optimal performance.
Adequate storage space to accommodate the model and any additional dependencies.

Operating System:

macOS Monterey (12.0) or later is recommended to ensure compatibility with the required software and libraries[3].

Software Dependencies:

Python: A recent version of Python (3.8 or higher) is necessary. You can download it from the official Python website or use a package manager like Homebrew.
pip: Python's package installer, which is used to install other required libraries.
Git: For cloning repositories that contain the model and related scripts.

Apple Developer Tools:

Xcode: While not strictly required, having Xcode installed can help resolve some dependency issues and ensure you have the necessary compilers and tools.

Step-by-Step Installation Guide

Follow these steps to install and set up DeepHermes 3 on your macOS system:

1. Install Python

If you don't already have Python installed, follow these steps:

Using Homebrew (Recommended):
- Open Terminal.
Using the Official Installer:
- Download the latest version of Python from the official Python website.
- Follow the on-screen instructions to install Python.
- Ensure that you add Python to your PATH during the installation process.

Run the command:

brew install python

2. Verify Python and pip Installation

Open Terminal and run the following commands to verify that Python and pip are installed correctly:

python3 --version
pip3 --version

These commands should display the versions of Python and pip installed on your system.

3. Install Git

If Git is not already installed, use the following command in Terminal:

brew install git

Verify the installation by running:

git --version

4. Clone the DeepHermes 3 Repository

Navigate to the directory where you want to store the DeepHermes 3 files and clone the repository. The exact repository URL will depend on where the model is hosted. For this example, let’s assume the repository is on GitHub:

git clone https://github.com/username/DeepHermes-3.git
cd DeepHermes-3

Replace https://github.com/username/DeepHermes-3.git with the actual URL of the DeepHermes 3 repository.

5. Create a Virtual Environment

It is best practice to create a virtual environment to manage dependencies for your project. This prevents conflicts with other Python projects on your system:

python3 -m venv venv
source venv/bin/activate

The first command creates a virtual environment named venv, and the second command activates it.

6. Install Required Python Packages

Navigate to the repository directory and install the necessary Python packages using pip. Typically, a requirements.txt file lists these dependencies:

pip3 install -r requirements.txt

If there is no requirements.txt file, you will need to identify the required packages manually and install them individually:

pip3 install package1 package2 package3

Common packages might include torch, transformers, and other libraries for natural language processing and machine learning.

7. Download the DeepHermes 3 Model

Download the DeepHermes 3 model weights and configuration files. This step depends on where the model is hosted. If the model is available on Hugging Face Model Hub, you can download it using the transformers library:

from transformers import AutoModelForCausalLM, AutoTokenizer

model_name = "NousResearch/DeepHermes-3"  # Replace with the actual model name
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(model_name)

model.save_pretrained("./deep hermes")
tokenizer.save_pretrained("./deep hermes")

This code downloads the model and tokenizer and saves them to a local directory named "deep hermes". Make sure to replace "NousResearch/DeepHermes-3" with the correct model name.

8. Run DeepHermes 3

After installing the model and dependencies, you can run DeepHermes 3 using a Python script. Here’s a basic example:

from transformers import AutoModelForCausalLM, AutoTokenizer

model_name = "./deep hermes"  # Path to the downloaded model
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForCausalLM.from_pretrained(model_name)

def generate_text(prompt, max_length=150):
    input_ids = tokenizer.encode(prompt, return_tensors="pt")
    output = model.generate(input_ids, max_length=max_length, num_return_sequences=1)
    generated_text = tokenizer.decode(output[0], skip_special_tokens=True)
    return generated_text

prompt = "Write a short story about a cat who goes on an adventure."
generated_text = generate_text(prompt)
print(generated_text)

Save this script as run_deep hermes.py and execute it using:

python3 run_deep hermes.py

This script loads the model and tokenizer, defines a function to generate text, and then prints the generated text based on the provided prompt.

Granting Full Disk Access

To ensure DeepHermes 3 functions correctly, granting full disk access might be necessary, especially if the application needs to access files in protected directories. Here’s how to do it:

Open System Preferences:

Click the Apple menu in the top-left corner of your screen.
Select "System Preferences".

Go to Security & Privacy:

Click on "Security & Privacy".

Select the Privacy Tab:

Choose the "Privacy" tab.

Grant Full Disk Access:

In the left panel, scroll down and select "Full Disk Access".
Click the lock icon in the bottom-left corner to make changes.
Enter your administrator password when prompted.
Click the "+" button to add an application.
Find the application or script you are using to run DeepHermes 3 (e.g., Python, Terminal) and select it.
Ensure the checkbox next to the application is checked.

Restart the Application:

Restart the application or script for the changes to take effect.

Ensuring Background Execution

To allow DeepHermes 3 to run without interruption, especially for long tasks, ensure it can execute in the background[1]. macOS has features that can limit background execution to save power, so you may need to adjust these settings:

Disable App Nap:

App Nap reduces the performance of applications running in the background. To disable it for DeepHermes 3:

Open Finder.
Go to the Applications folder.
Find the application you are using to run DeepHermes 3 (e.g., Terminal).
Right-click on the application and select "Get Info".
Check the box labeled "Prevent App Nap".

Energy Saver Settings:

Adjust the Energy Saver settings to prevent the system from sleeping or reducing performance when idle:

Open System Preferences.
Click on "Energy Saver".
Adjust the settings according to your needs. For example, you might want to prevent the display from sleeping or prevent the computer from going to sleep automatically.

Troubleshooting Common Issues

Encountering issues during installation or execution is not uncommon. Here are some troubleshooting steps for common problems:

Dependency Issues:
- Problem: Missing or incompatible Python packages.
Permissions Issues:
- Problem: The script or application does not have the necessary permissions to access files or directories.
- Solution: Grant full disk access to the application or script. Ensure that you are running the script with the necessary privileges (e.g., using sudo if required).
Model Loading Issues:
- Problem: The model fails to load due to incorrect file paths or corrupted model files.
- Solution: Double-check the file paths to the model and tokenizer. Ensure that the model files are not corrupted by re-downloading them.
Memory Issues:
- Problem: The system runs out of memory when running the model, especially for large prompts or long text generation tasks.
- Solution: Reduce the batch size or the maximum length of the generated text. Close other applications to free up memory. Consider upgrading your system's RAM if the issue persists.
System Extension Issues:
- Problem: System extensions required by DeepHermes 3 are not enabled[1].
- Solution:
  - Open "System Preferences" and go to "Security & Privacy".
  - If there is a message about blocked system extensions, click "Allow".
  - Repeat this for all system extensions distributed with DeepHermes 3.
Network Traffic Filtering:
- Problem: The application prompts for permission to filter network traffic[1].
- Solution: When prompted, select "Allow" to grant the necessary permissions.

Solution: Ensure all required packages are installed using pip. Double-check the versions of the packages to ensure they are compatible with DeepHermes 3.

pip3 install --upgrade package_name

Optimizing Performance

To get the best performance from DeepHermes 3 on your macOS system, consider the following optimizations:

Use a GPU (if available): If your Mac has a dedicated GPU, configure the model to use it. This can significantly speed up the text generation process. You may need to install additional libraries like torch-metal to enable GPU support.
Quantization: Quantization reduces the memory footprint and computational requirements of the model by reducing the precision of the weights. This can improve performance, especially on systems with limited resources.
Batching: Process multiple prompts in a batch to take advantage of parallel processing. This can increase throughput and reduce the overall processing time.
Caching: Implement caching mechanisms to store frequently accessed data and reduce the need to recompute it. This can be particularly effective for repetitive tasks.

Alternative Installation Methods

Besides the manual installation method, consider using containerization technologies like Docker to simplify the deployment process. Docker allows you to create a consistent environment that includes all the necessary dependencies, making it easier to run DeepHermes 3 on different systems.

Install Docker:

Download and install Docker Desktop for Mac from the official Docker website.
Create a Dockerfile that specifies the environment and dependencies for DeepHermes 3.
Navigate to the directory containing the Dockerfile and run:
Run the Docker container using:

Run the Docker Container:

docker run deep hermes-3

Build the Docker Image:

docker build -t deep hermes-3 .

Create a Dockerfile:

FROM python:3.8

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

CMD ["python3", "run_deep hermes.py"]

This approach encapsulates the application and its dependencies, ensuring consistency and portability.

Keeping Your System Up to Date

To maintain optimal performance and security, keep your macOS system and all installed software up to date. Regularly check for updates using the Software Update feature in System Preferences.

Conclusion

Running DeepHermes 3 on macOS involves several steps, from ensuring your system meets the prerequisites to installing the necessary dependencies and configuring the model.