Docs m1

.github/workflows/continous-integration.yml

@@ -552,9 +552,6 @@ jobs:
         uses: actions/checkout@v3
         if: github.event_name != 'pull_request'
 
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v1
-
       - name: Read Poetry Version 🔢
         run: |
           echo "POETRY_VERSION=$(scripts/poetry-version.sh)" >> $GITHUB_ENV
@@ -624,30 +621,26 @@ jobs:
         if: steps.check_image.outputs.base_exists == 'false' || env.IS_TAG_BUILD == 'true'
         run: |
           export IMAGE_TAG=${{ steps.check_image.outputs.base_image_hash }}
-          docker buildx bake --set *.platform=linux/amd64 -f docker/docker-bake.hcl base --push
-          docker buildx bake --set *.platform=linux/arm64 -f docker/docker-bake.hcl base --push
+          docker buildx bake -f docker/docker-bake.hcl base --push
 
       - name: Build Docker mitie base image and push 🛠 ⬆
         if: steps.check_image.outputs.base_mitie_exists == 'false'
         run: |
           export IMAGE_TAG=${{ steps.check_image.outputs.base_mitie_image_hash }}
-          docker buildx bake --set *.platform=linux/amd64 -f docker/docker-bake.hcl base-mitie --push
-          docker buildx bake --set *.platform=linux/arm64 -f docker/docker-bake.hcl base-mitie --push
+          docker buildx bake -f docker/docker-bake.hcl base-mitie --push
 
       - name: Build Docker poetry base image and push 🛠 ⬆
         if: steps.check_image.outputs.base_poetry_exists == 'false'
         run: |
           export IMAGE_TAG=${{ env.POETRY_VERSION }}
           export BASE_IMAGE_HASH=${{ steps.check_image.outputs.base_image_hash }}
-          docker buildx bake --set *.platform=linux/amd64 -f docker/docker-bake.hcl base-poetry --push
-          docker buildx bake --set *.platform=linux/arm64 -f docker/docker-bake.hcl base-poetry --push
+          docker buildx bake -f docker/docker-bake.hcl base-poetry --push
 
       - name: Build Docker builder base image and push 🛠 ⬆
         if: steps.check_image.outputs.base_builder_exists == 'false'
         run: |
           export IMAGE_TAG=${{ steps.check_image.outputs.base_builder_image_hash }}
-          docker buildx bake --set *.platform=linux/amd64 -f docker/docker-bake.hcl base-builder --push
-          docker buildx bake --set *.platform=linux/arm64 -f docker/docker-bake.hcl base-builder --push
+          docker buildx bake -f docker/docker-bake.hcl base-builder --push
 
       # Set environment variables for a pull request
       #
@@ -704,7 +697,6 @@ jobs:
     strategy:
       matrix:
         image: [default, full, mitie-en, spacy-de, spacy-en]
-        arch: [linux/amd64, linux/arm64]
 
     steps:
       # Due to an issue with checking out a wrong commit, we make sure
@@ -720,9 +712,6 @@ jobs:
         uses: actions/checkout@v3
         if: github.event_name != 'pull_request'
 
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v2
-
       - name: Free disk space
         if: needs.changes.outputs.docker == 'true'
         # tries to make sure we do not run out of disk space, see
@@ -746,9 +735,6 @@ jobs:
           version: v0.5.1
           driver: docker
 
-      - name: Echo Available platforms
-        run: echo ${{ steps.buildx.outputs.platforms }}
-
       - name: Login to DockerHub Registry 🔢
         if: needs.changes.outputs.docker == 'true'
         run: echo ${{ secrets.DOCKERHUB_PASSWORD }} | docker login -u ${{ env.DOCKERHUB_USERNAME }} --password-stdin || true
@@ -764,19 +750,19 @@ jobs:
       - name: Build Docker image
         if: needs.changes.outputs.docker == 'true'
         run: |
-          docker buildx bake --set *.platform=${{ matrix.arch }} -f docker/docker-bake.hcl ${{ matrix.image }}
+          docker buildx bake -f docker/docker-bake.hcl ${{ matrix.image }}
 
       - name: Push image with main tag 📦
         if: needs.changes.outputs.docker == 'true' && github.event_name == 'push' && github.ref == 'refs/heads/main' && github.repository == 'RasaHQ/rasa'
         run: |
-          docker buildx bake --set *.platform=${{ matrix.arch }} -f docker/docker-bake.hcl ${{ matrix.image }} --push
+          docker buildx bake -f docker/docker-bake.hcl ${{ matrix.image }} --push
 
       - name: Push image with ${{github.ref}} tag 📦
         if: needs.changes.outputs.docker == 'true' && github.event_name == 'push' && env.IS_TAG_BUILD == 'true' && github.repository == 'RasaHQ/rasa'
         run: |
           IS_NEWEST_VERSION=${{ needs.build_docker_base_images_and_set_env.outputs.is_newest_version }}
 
-          docker buildx bake --set *.platform=${{ matrix.arch }} -f docker/docker-bake.hcl ${{ matrix.image }} --push
+          docker buildx bake -f docker/docker-bake.hcl ${{ matrix.image }} --push
 
           # Tag the image as latest
           if [[ "${IS_NEWEST_VERSION}" == "true" ]]; then

changelog/ATO-320.improvement.md

@@ -0,0 +1,2 @@
+Rasa supports native installations on Apple Silicon (M1 / M2). Please
+follow the installation instructions and take a look at the limitations.

docs/docs/components.mdx

@@ -495,6 +495,8 @@ Note: The `feature-dimension` for sequence and sentence features does not have t
   :::note
   To use `ConveRTFeaturizer`, install Rasa Open Source with `pip3 install rasa[convert]`.
 
+  Note that this component cannot currently run on MacOS using M1 / M2 architecture. 
+  More information on this limitation is available [here](./installation.mdx#m1--m2-apple-silicon-limitations).
   :::
 
 

docs/docs/installation.mdx

@@ -38,6 +38,17 @@ your machine and continue development locally.
   </TabItem>
   <TabItem value="macos">
 
+:::info
+
+Rasa supports **x86_64 (Intel) and M1 / M2 (Apple Silicon)** architectures.
+The support is for development purposes only and we strongly recommend 
+production deployments to use Ubuntu / Linux on x86_64.
+
+More information about the limitations of rasa installations on Apple Silicon can be found
+in this [section](#m1--m2-apple-silicon-limitations).
+
+:::
+
   Create a new virtual environment by choosing a Python interpreter and making a `./venv` directory to hold it:
 
   ```bash
@@ -86,10 +97,6 @@ rasa init
 
 You can learn about the most important Rasa commands in the [Command Line Interface](./command-line-interface.mdx).
 
-:::note
-Due to the lack of official TensorFlow support for the Apple M1, Rasa Open Source is currently unable to train a model using M1.
-:::
-
 ## Step-by-step Installation Guide
 
 Prefer following video instructions? Watch our installation series on
@@ -316,3 +323,25 @@ To download a specific version, specify the version number:
 ```bash
 pip3 install rasa==3.0
 ```
+
+## M1 / M2 (Apple Silicon) Limitations
+
+Rasa installations on Apple Silicon use [Apple Metal](https://developer.apple.com/metal/) leading to reduced training times
+for local development.
+
+Currently, not all of Rasa's dependencies support Apple Silicon natively. This leads
+to the following restrictions:
+
+* You can not run Duckling as a docker container on Apple Silicon. If you want
+  to use the [duckling entity extractor](components.mdx#ducklingentityextractor) we recommend a cloud deployment of 
+  duckling. Progress on this can be tracked on the 
+  [Duckling project](https://github.com/facebook/duckling/issues/695).
+* You cannot run Rasa in a Docker container on Apple Silicon, only native installations
+  currently work. An installation in docker requires support for Ubuntu aarch64
+  which the current tensorflow version 2.8 does not provide - only MacOS is 
+  supported as an operating system running on aarch64. We expect a future
+  upgrade of Tensorflow to allow Apple Silicon users to run Rasa inside of Docker.
+* Rasa on Apple Silicon does not support the [`ConveRTFeaturizer` component](components.mdx#convertfeaturizer) or pipelines
+  containing it. The component relies on `tensorflow-text` which currently
+  isn't available for Apple Silicon. Progress on this can be tracked on the 
+  [Tensorflow Text project](https://github.com/tensorflow/text/issues/823).