doc for Spaces #189
Merged
doc for Spaces #189
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
julien-c
requested review from
n1t0,
gary149,
Pierrci,
osanseviero,
cbensimon,
LysandreJik and
jeffboudier
cbensimon
approved these changes
Jul 14, 2021
| @@ -5,7 +5,7 @@ title: Hugging Face Hub Endpoints | |||
| # Hugging Face Hub API Endpoints | |||
|
|
|||
|
|
|||
| We have open endpoints that you can use to retrieve information from the Hub as well as perform certain actions such as creating model repos. We offer a wrapper Python library, [`huggingface_hub`](https://github.com/huggingface/huggingface_hub), that allows easy access to these endpoints. We also provide a webhook to receive real-time incremental info about models. Enjoy! | |||
| We have open endpoints that you can use to retrieve information from the Hub as well as perform certain actions such as creating model repos. We offer a wrapper Python library, [`huggingface_hub`](https://github.com/huggingface/huggingface_hub), that allows easy access to these endpoints. We also provide a [webhook](#webhook) to receive real-time incremental info about models. Enjoy! | |||
|
This is awesome - it'd be great to let participants try that out :-) In the docs it says that |
patrickvonplaten
approved these changes
Jul 14, 2021
Co-authored-by: Patrick von Platen <patrick.v.platen@gmail.com>
Our thinking with @cbensimon was to be model-agnostic (the hub is not just for |
osanseviero
approved these changes
Jul 15, 2021
| @@ -0,0 +1,95 @@ | |||
| --- | |||
| title: Documentation for Spaces | |||
There was a problem hiding this comment.
Do we have any thumbnail we could add here?
|
|
||
| <h1>How to get started with Spaces</h1> | ||
|
|
||
| > ⚠️ This feature is currently in private beta, reach out to [julien-c](https://huggingface.co/julien-c) if you'd like to try it out ⚠️ |
There was a problem hiding this comment.
I don't think https://huggingface.co/julien-c provides any email to contact you, should this be your email instead?
n1t0
approved these changes
Jul 15, 2021
|
|
||
| ## How does it work? | ||
|
|
||
| We deploy a containerized version of your code on our Infra, each time you commit. As a sidenote, we have many cool infra challenges to solve, if you'd like to help us, please consider reaching out 🙂. |
jeffboudier
reviewed
Jul 15, 2021
| <!-- Add screencap of listing directory --> | ||
|
|
||
| Finally, we've been thinking of providing a way to run **custom apps**, for instance Python server code for the backend + a unified set of widgets/frontend JS code, or even custom Docker image serving. Do get in touch if you would like to build something more custom. | ||
|
|
There was a problem hiding this comment.
Suggested change
| ## Can I create private Spaces? | |
| Yes! Just like with models and datasets, a Hugging Face subscription will allow you to set a new Space as private when creating it. You can create a private Space for your account, or share a private Space within your organization. [Check our our plans](https://huggingface.co/pricing) to get started. |
There was a problem hiding this comment.
technically aren't restricted to Paid users, but we can still have this wording to promote Pro accounts (it's remaining in other parts of the doc too)
|
Do we, or can we enable Private Spaces for subscribers only? Assuming it's
the case, left a suggestion to message it in the doc.
…On Thu, Jul 15, 2021 at 10:48 AM Julien Chaumond ***@***.***> wrote:
***@***.**** commented on this pull request.
------------------------------
In docs/hub/spaces.md
<#189 (comment)>
:
> +
+<!-- TODO(have someone record a Youtube demo of Spaces showcasing some cool apps already running, etc) -->
+
+## Should I use Streamlit or Gradio?
+
+We recommend you try both as they're both really awesome! 😎
+
+Streamlit's documentation is at https://docs.streamlit.io/, and Gradio's doc is https://gradio.app/docs.
+
+In the default environment, we're currently running version `"0.79.0"` of Streamlit and version `"2.0.9"` of Gradio.
+
+Our 2 cents:
+- **Gradio** is great if you want to build a super-easy-to-use interface to run a model from just the list of its inputs and its outputs. The Gradio team wrote a great [tutorial on our blog](https://huggingface.co/blog/gradio).
+- **Streamlit** gives you more freedom to build a full-featured Web app from Python, in a _reactive_ way (meaning that code gets re-run when the state of the app changes).
+
+You can also take a look at some sample apps on the [Spaces directory](https://huggingface.co/spaces) to make up your mind.
it will when this is live (upcoming PR) ;)
—
You are receiving this because your review was requested.
Reply to this email directly, view it on GitHub
<#189 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/ARWHZBKOL2YIQVQEMCAVMX3TX2OEBANCNFSM5ALLKZJQ>
.
|
julien-c
commented
Jul 15, 2021
julien-c
commented
Jul 15, 2021
|
Thanks everyone for the reviews, I think I addressed everything, but do let me know if i missed anything |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Screen capture: