doc for Spaces #189

julien-c · 2021-07-14T12:26:06Z

Screen capture:

cbensimon

Really neat !

(I just need to actually implement pre-installed dependencies and finish Secrets management for the doc to be totally accurate)

cbensimon · 2021-07-14T13:33:29Z

docs/hub/endpoints.md

@@ -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!


Unrelated ?

docs/hub/spaces.md

patrickvonplaten · 2021-07-14T18:16:56Z

This is awesome - it'd be great to let participants try that out :-)

In the docs it says that transfomers is not pre-installed. Should we have transformers pre-installed as well next to datasets?

docs/hub/spaces.md

Co-authored-by: Patrick von Platen <patrick.v.platen@gmail.com>

julien-c · 2021-07-14T18:25:56Z

In the docs it says that transfomers is not pre-installed. Should we have transformers pre-installed as well next to datasets?

Our thinking with @cbensimon was to be model-agnostic (the hub is not just for transformers), but i agree it'd be convenient to have it by default – maybe we can have it but not mention it in the doc?

osanseviero

This is awesome! 🎉

Looking forward to this

docs/hub/spaces.md

osanseviero · 2021-07-14T13:00:28Z

docs/hub/spaces.md

@@ -0,0 +1,95 @@
+---
+title: Documentation for Spaces


Do we have any thumbnail we could add here?

osanseviero · 2021-07-15T06:04:48Z

docs/hub/spaces.md

+
+<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 ⚠️


I don't think https://huggingface.co/julien-c provides any email to contact you, should this be your email instead?

LysandreJik

Looks great!

n1t0

Awesome, looks great!

n1t0 · 2021-07-15T09:42:47Z

docs/hub/spaces.md

+
+## 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 · 2021-07-15T09:47:32Z

docs/hub/spaces.md

+<!-- 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.
+


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/#) to get started.

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)

jeffboudier · 2021-07-15T09:47:56Z

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)> : > + + + +## 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> .

docs/hub/spaces.md

julien-c · 2021-07-15T13:51:59Z

Thanks everyone for the reviews, I think I addressed everything, but do let me know if i missed anything

julien-c added 3 commits July 14, 2021 14:09

spaces

4bef283

tweaks

97ae73a

link to logo

9b6140b

julien-c requested review from n1t0, gary149, Pierrci, osanseviero, cbensimon, LysandreJik and jeffboudier July 14, 2021 12:26

julien-c added the documentation Improvements or additions to documentation label Jul 14, 2021

julien-c requested a review from nateraw July 14, 2021 12:27

cbensimon approved these changes Jul 14, 2021

View reviewed changes

patrickvonplaten reviewed Jul 14, 2021

View reviewed changes

docs/hub/spaces.md Outdated Show resolved Hide resolved

patrickvonplaten approved these changes Jul 14, 2021

View reviewed changes

suggestion from @patrickvonplaten

8ac524c

Co-authored-by: Patrick von Platen <patrick.v.platen@gmail.com>

osanseviero approved these changes Jul 15, 2021

View reviewed changes

LysandreJik approved these changes Jul 15, 2021

View reviewed changes

julien-c requested a review from suzana-ilic July 15, 2021 08:47

n1t0 approved these changes Jul 15, 2021

View reviewed changes

jeffboudier reviewed Jul 15, 2021

View reviewed changes

julien-c commented Jul 15, 2021

View reviewed changes

docs/hub/spaces.md Outdated Show resolved Hide resolved

Suggestion from @abidlabs

670523b

julien-c commented Jul 15, 2021

View reviewed changes

docs/hub/spaces.md Outdated Show resolved Hide resolved

⚠️

27595ea

julien-c merged commit b93cc68 into main Jul 15, 2021

julien-c deleted the docs-spaces branch July 15, 2021 13:41

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc for Spaces #189

doc for Spaces #189

julien-c commented Jul 14, 2021

cbensimon left a comment

cbensimon Jul 14, 2021

julien-c Jul 14, 2021

patrickvonplaten commented Jul 14, 2021

julien-c commented Jul 14, 2021

osanseviero left a comment

osanseviero Jul 14, 2021

osanseviero Jul 15, 2021

LysandreJik left a comment

n1t0 left a comment

n1t0 Jul 15, 2021

jeffboudier Jul 15, 2021

julien-c Jul 15, 2021

jeffboudier commented Jul 15, 2021 via email

julien-c commented Jul 15, 2021


		<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 ⚠️


		## 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 🙂.

		<!-- 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.


	## 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/#) to get started.

doc for Spaces #189

doc for Spaces #189

Conversation

julien-c commented Jul 14, 2021

cbensimon left a comment

Choose a reason for hiding this comment

cbensimon Jul 14, 2021

Choose a reason for hiding this comment

julien-c Jul 14, 2021

Choose a reason for hiding this comment

patrickvonplaten commented Jul 14, 2021

julien-c commented Jul 14, 2021

osanseviero left a comment

Choose a reason for hiding this comment

osanseviero Jul 14, 2021

Choose a reason for hiding this comment

osanseviero Jul 15, 2021

Choose a reason for hiding this comment

LysandreJik left a comment

Choose a reason for hiding this comment

n1t0 left a comment

Choose a reason for hiding this comment

n1t0 Jul 15, 2021

Choose a reason for hiding this comment

jeffboudier Jul 15, 2021

Choose a reason for hiding this comment

julien-c Jul 15, 2021

Choose a reason for hiding this comment

jeffboudier commented Jul 15, 2021 via email

julien-c commented Jul 15, 2021