diff --git a/components/sensor/kamstrup_kmp.rst b/components/sensor/kamstrup_kmp.rst
index b0a4ef0fe4..b45e81fc06 100644
--- a/components/sensor/kamstrup_kmp.rst
+++ b/components/sensor/kamstrup_kmp.rst
@@ -99,7 +99,7 @@ lines to the pins configured under the uart section in the config file.
Optical reader schematic
-To safe energy, the optical interface of the Kamstrup meter is not active by default.
+To save energy, the optical interface of the Kamstrup meter is not active by default.
To activate the interface, press a button on the device. The interface will now be
available for a few minutes. To keep the interface alive, magnets must be placed
around the LED / photo diode. The image below shows the arrangement. The green
diff --git a/guides/installing_esphome.rst b/guides/installing_esphome.rst
index 4535ac6764..e990705527 100644
--- a/guides/installing_esphome.rst
+++ b/guides/installing_esphome.rst
@@ -49,19 +49,62 @@ with the following:
Mac
---
-There are no tested installation instructions for Mac. ESPHome does support
-Mac & will run with no problem.
+ESPHome supports macOS. There are several ways to install ESPHome on macOS:
-Contributions are welcome!
+- Homebrew
+- pip
+- Cloning the repository
-The process will likely be similar to Windows. You can install Python from the
-official site, and then install ESPHome with ``pip3 install esphome``. You can
-then test that things are properly installed with the following:
+
+**Homebrew**
+
+An easy way for installation is via `Homebrew `_:
+
+.. code-block:: console
+
+ $ brew install esphome
+
+Verify the installation:
.. code-block:: console
$ esphome version
- Version: 2021.12.3
+ Version: 2024.12.0
+
+If you encounter any issues with Homebrew installation, please check the
+`ESPHome Homebrew Formula `_ page
+for additional information.
+
+.. note::
+
+ Homebrew may not always provide the latest version immediately. Updating Homebrew will
+ automatically update ESPHome. If this is ok for you, Homebrew is the easiest way to
+ install ESPHome.
+
+**pip**
+
+For the latest version, use the pip installation. This may be more difficult to set up
+and may need additional dependencies and path settings. Setting up a virtual environment is
+highly recommended. If you are not familiar with Python virtual environments, Homebrew
+may be easier.
+
+You will require Python 3.9 or newer. While your Mac may have a version of Python installed it may not be up-to-date.
+Python can be installed from the `official site `_
+or with Homebrew. Once Python is installed, create and activate a virtual environment and install ESPHome with pip:
+
+.. code-block:: console
+
+ $ python3 -m venv venv # The last argument is the folder in which to install the virtual environment
+ $ source venv/bin/activate # For bash or compatible shells. If using a different shell, use activate.csh or activate.fish
+ (venv) $ pip install esphome # Installs ESPHome in the virtual environment
+ (venv) $ esphome version
+
+Any time you want to use ESPHome, you will need to have activated the virtual environment as shown above. When activated you will see ``(venv)`` at the beginning of your prompt.
+
+**Cloning the repository**
+
+For development purposes of ESPhome cloning the repository is recommended.
+See :ref:`setup_dev_env` for more information on setting up a development environment.
Linux
-----
@@ -120,4 +163,5 @@ See Also
- :doc:`ESPHome index `
- :doc:`getting_started_command_line`
+- :doc:`contributing`
- :ghedit:`Edit`