Add application files

README.md

@@ -12,7 +12,7 @@ license: mit
 
 <!-- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference --># Hugging Face Spaces From A Notebook
 
-> A demo of using nbdev with Hugging Face Spaces
+> A demo of using nbdev with Hugging Face Spaces & Gradio
 
 ## 1. Create a Gradio-enabled Space on Hugging Face
 
@@ -24,7 +24,7 @@ After you are done creating the space, **clone the repo per the instructions pro
 
 ## 2. Make an app with Gradio
 
-Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces).
+Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces). 
 
 First, lets specify the libraries we need, which in this case are `gradio` and `fastcore`:
 
@@ -35,6 +35,8 @@ import gradio as gr
 from fastcore.net import urljson, HTTPError
 ```
 
+Next, write the functions your gradio app will use.  Because of [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/), you can prototype and package your code all in one place.  **The special comment `#|export` marks which cells will be sent to a python script** (more on this later). Note that there are only three cells in this notebook with the `#|export` directive.
+
 
 ```
 #|export
@@ -101,7 +103,7 @@ iface.close()
 
 ## 3. Converting This Notebook Into A Gradio App
 
-In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  That is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:
+In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  As a reminder, this is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:
 
 
 ```
@@ -154,7 +156,7 @@ Notice how the contents of app.py only contains the exported cells from this not
 
 ### Fill out `requirements.txt`
 
-You must supply a requirements.txt file so the gradio app knows how to build your dependencies.  In this example, the only depdency other than gradio is `fastcore`.  You don't need to specify gradio itself as a depdendency in `requirements.txt` so our `requirements.txt` file has only one dependency:
+You must supply a requirements.txt file so the Gradio app knows how to build your dependencies.  In this example, the only dependency other than Gradio is `fastcore`.  You don't need to specify Gradio itself as a dependency in `requirements.txt`, so our `requirements.txt` file has only one dependency:
 
 
 ```
@@ -165,7 +167,7 @@ You must supply a requirements.txt file so the gradio app knows how to build you
 
 ## 4. Launch Your Gradio App
 
-To launch your gradio app, you need to commit the changes in the Hugging Face repo:
+To launch your gradio app, you need to commit the changes to the Hugging Face repo:
 
 ```
 git add -A; git commit -m "Add application files"; git push
@@ -175,6 +177,10 @@ git add -A; git commit -m "Add application files"; git push
 
 After a couple of minutes, you will see your app published!  This app is published at https://huggingface.co/spaces/hamel/hfspace_demo.
 
+# Shameless Plug: [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)
+
+Hopefully you felt something magical while doing this example.  Even though the target application required you to write a python script (`app.py`), you didn't have to refactor your script from a notebook!  We believe that you shouldn't have to refactor your code and switch contexts even when creating python packages!  If this intrigues you, check out [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)
+
 
 ```
 

app.ipynb

@@ -7,7 +7,7 @@
    "source": [
     "# Hugging Face Spaces From A Notebook\n",
     "\n",
-    "> A demo of using nbdev with Hugging Face Spaces"
+    "> A demo of using nbdev with Hugging Face Spaces & Gradio"
    ]
   },
   {
@@ -54,7 +54,7 @@
    "id": "14a884fc-36e2-43ec-8e42-ca2903aaa4de",
    "metadata": {},
    "source": [
-    "Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces).\n",
+    "Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces). \n",
     "\n",
     "First, lets specify the libraries we need, which in this case are `gradio` and `fastcore`:"
    ]
@@ -71,6 +71,14 @@
     "from fastcore.net import urljson, HTTPError"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "ecc45936-fc16-4e60-b4b7-c323900666c7",
+   "metadata": {},
+   "source": [
+    "Next, write the functions your gradio app will use.  Because of [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/), you can prototype and package your code all in one place.  **The special comment `#|export` marks which cells will be sent to a python script** (more on this later). Note that there are only three cells in this notebook with the `#|export` directive."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -211,7 +219,7 @@
    "id": "5c18ca6e-8de8-49e1-b95a-304070bbc171",
    "metadata": {},
    "source": [
-    "In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  That is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:"
+    "In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  As a reminder, this is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:"
    ]
   },
   {
@@ -303,7 +311,7 @@
    "source": [
     "### Fill out `requirements.txt`\n",
     "\n",
-    "You must supply a requirements.txt file so the gradio app knows how to build your dependencies.  In this example, the only depdency other than gradio is `fastcore`.  You don't need to specify gradio itself as a depdendency in `requirements.txt` so our `requirements.txt` file has only one dependency:"
+    "You must supply a requirements.txt file so the Gradio app knows how to build your dependencies.  In this example, the only dependency other than Gradio is `fastcore`.  You don't need to specify Gradio itself as a dependency in `requirements.txt`, so our `requirements.txt` file has only one dependency:"
    ]
   },
   {
@@ -331,7 +339,7 @@
    "source": [
     "## 4. Launch Your Gradio App\n",
     "\n",
-    "To launch your gradio app, you need to commit the changes in the Hugging Face repo:\n",
+    "To launch your gradio app, you need to commit the changes to the Hugging Face repo:\n",
     "\n",
     "```\n",
     "git add -A; git commit -m \"Add application files\"; git push\n",
@@ -354,10 +362,26 @@
     "After a couple of minutes, you will see your app published!  This app is published at https://huggingface.co/spaces/hamel/hfspace_demo."
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "a9832cfb-9fe9-47e3-9928-1a1fd4b85bdd",
+   "metadata": {},
+   "source": [
+    "# Shameless Plug: [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8a7e43cc-104a-43b0-9433-a5b515c3a8d2",
+   "metadata": {},
+   "source": [
+    "Hopefully you felt something magical while doing this example.  Even though the target application required you to write a python script (`app.py`), you didn't have to refactor your script from a notebook!  We believe that you shouldn't have to refactor your code and switch contexts even when creating python packages!  If this intrigues you, check out [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "52bacbff-63fc-492e-805c-6252c1ce2150",
+   "id": "9a8ea66e-236c-416a-8958-dcf813a5f8c9",
    "metadata": {},
    "outputs": [],
    "source": []

app.md

@@ -1,6 +1,6 @@
 # Hugging Face Spaces From A Notebook
 
-> A demo of using nbdev with Hugging Face Spaces
+> A demo of using nbdev with Hugging Face Spaces & Gradio
 
 ## 1. Create a Gradio-enabled Space on Hugging Face
 
@@ -12,7 +12,7 @@ After you are done creating the space, **clone the repo per the instructions pro
 
 ## 2. Make an app with Gradio
 
-Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces).
+Below, we will create a [gradio](https://gradio.app/) app in a notebook and show you how to deploy it to [Hugging Face Spaces](https://huggingface.co/docs/hub/spaces). 
 
 First, lets specify the libraries we need, which in this case are `gradio` and `fastcore`:
 
@@ -23,6 +23,8 @@ import gradio as gr
 from fastcore.net import urljson, HTTPError
 ```
 
+Next, write the functions your gradio app will use.  Because of [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/), you can prototype and package your code all in one place.  **The special comment `#|export` marks which cells will be sent to a python script** (more on this later). Note that there are only three cells in this notebook with the `#|export` directive.
+
 
 ```
 #|export
@@ -89,7 +91,7 @@ iface.close()
 
 ## 3. Converting This Notebook Into A Gradio App
 
-In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  That is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:
+In order to host this code on Hugging Faces spaces, you will export parts of this notebook to a script named `app.py`.  As a reminder, this is what the special `#|export` comment that you have seen in cells above do!  You can export code from this notebook like so:
 
 
 ```
@@ -142,7 +144,7 @@ Notice how the contents of app.py only contains the exported cells from this not
 
 ### Fill out `requirements.txt`
 
-You must supply a requirements.txt file so the gradio app knows how to build your dependencies.  In this example, the only depdency other than gradio is `fastcore`.  You don't need to specify gradio itself as a depdendency in `requirements.txt` so our `requirements.txt` file has only one dependency:
+You must supply a requirements.txt file so the Gradio app knows how to build your dependencies.  In this example, the only dependency other than Gradio is `fastcore`.  You don't need to specify Gradio itself as a dependency in `requirements.txt`, so our `requirements.txt` file has only one dependency:
 
 
 ```
@@ -153,7 +155,7 @@ You must supply a requirements.txt file so the gradio app knows how to build you
 
 ## 4. Launch Your Gradio App
 
-To launch your gradio app, you need to commit the changes in the Hugging Face repo:
+To launch your gradio app, you need to commit the changes to the Hugging Face repo:
 
 ```
 git add -A; git commit -m "Add application files"; git push
@@ -163,6 +165,10 @@ git add -A; git commit -m "Add application files"; git push
 
 After a couple of minutes, you will see your app published!  This app is published at https://huggingface.co/spaces/hamel/hfspace_demo.
 
+# Shameless Plug: [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)
+
+Hopefully you felt something magical while doing this example.  Even though the target application required you to write a python script (`app.py`), you didn't have to refactor your script from a notebook!  We believe that you shouldn't have to refactor your code and switch contexts even when creating python packages!  If this intrigues you, check out [nbdev](https://nbdev.fast.ai/blog/posts/2022-07-28-nbdev2/)
+
 
 ```