Add conda-forge instructions for mac (#134)

* update docs with conda forge

* tweak

* code review feedback

* link to issue; use admonition

README.md

@@ -2,6 +2,7 @@ CyFi: Cyanobacteria Finder
 ==============================
 
 [![PyPI](https://img.shields.io/pypi/v/cyfi.svg)](https://pypi.org/project/cyfi/)
+[![conda-forge](https://img.shields.io/conda/vn/conda-forge/cyfi.svg)](https://anaconda.org/conda-forge/cyfi)
 [![tests](https://github.com/drivendataorg/cyfi/workflows/tests/badge.svg?branch=main)](https://github.com/drivendataorg/cyfi/actions?query=workflow%3Atests+branch%3Amain)
 [![codecov](https://codecov.io/gh/drivendataorg/cyfi/branch/main/graph/badge.svg)](https://codecov.io/gh/drivendataorg/cyfi)
 
@@ -13,12 +14,21 @@ Read more at [cyfi.drivendata.org](https://cyfi.drivendata.org)
 
 ### Install
 
+> [!NOTE]
+> There is a known [issue](https://github.com/drivendataorg/cyfi/issues/114) with the pip installation on M1 Macs due to LightGBM. If you're on a Mac, we recommend installing CyFi with conda, shown in the second option below.
+
 Install CyFi with pip:
 
 ```
 pip install cyfi
 ```
 
+Alternatively, CyFi can be installed with conda:
+
+```
+conda install -c conda-forge cyfi
+```
+
 For detailed instructions for those installing python for the first time, see the [Installation](https://cyfi.drivendata.org/installation/) page.
 
 ### Generate batch predictions

docs/docs/index.md

@@ -20,12 +20,22 @@
 
 ### Install
 
+!!! note ""
+
+    Note: There is a known [issue](https://github.com/drivendataorg/cyfi/issues/114) with the pip installation on M1 Macs due to LightGBM. If you're on a Mac, we recommend installing CyFi with conda, shown in the second option below.
+
 Install CyFi with pip:
 
 ```
 pip install cyfi
 ```
 
+Alternatively, CyFi can be installed with conda:
+
+```
+conda install -c conda-forge cyfi
+```
+
 For detailed instructions for those installing python for the first time, see the [Installation](installation.md) docs.
 
 ### Generate batch predictions

docs/docs/installation.md

@@ -39,7 +39,7 @@ Once the Miniconda installation has finished,
 ```
 $ pip show cyfi
 Name: cyfi
-Version: 0.1.0
+Version: 1.1.2
 Summary: CyFi is a Python package to estimate cyanobacteria density in small, inland water bodies using Sentinel-2 satellite imagery.
 ```
 
@@ -64,14 +64,16 @@ Once the Miniconda installation has finished,
 
 1. Open the terminal by typing ⌘+space (to open spotlight search) and then typing "Terminal". Hit enter.
 
-2. Type `pip install cyfi` and hit enter
+2. Type `conda install -c conda-forge cyfi` and hit enter.
 
-3. To check that CyFi has been installed, run `pip show cyfi`
+3. When prompted with "Proceed ([y]/n)?", hit enter again.
+
+4. To check that CyFi has been installed, run `pip show cyfi`
 
 ```
 $ pip show cyfi
 Name: cyfi
-Version: 0.1.0
+Version: 1.1.2
 Summary: CyFi is a Python package to estimate cyanobacteria density in small, inland water bodies using Sentinel-2 satellite imagery.
 ```
 
@@ -102,6 +104,6 @@ Summary: CyFi is a Python package to estimate cyanobacteria density in small, in
 ```
 $ pip show cyfi
 Name: cyfi
-Version: 0.1.0
+Version: 1.1.2
 Summary: CyFi is a Python package to estimate cyanobacteria density in small, inland water bodies using Sentinel-2 satellite imagery.
 ```

docs/mkdocs.yml

@@ -16,6 +16,7 @@ nav:
   - Changelog: "changelog.md"
 
 markdown_extensions:
+  - admonition
   - toc:
       permalink: True
       toc_depth: 3