Spaces:
Runtime error
Runtime error
Added README.md with information on how to get started
Browse filesAdded README.md with information on how to get started, and fixed
typos in the Dockerfile
- Dockerfile +2 -2
- README.md +107 -3
Dockerfile
CHANGED
|
@@ -8,13 +8,13 @@ FROM heartexlabs/label-studio:hf-latest
|
|
| 8 |
# will full access to all projects and data. This is great for trying out
|
| 9 |
# Label Studio and collaborating on projects, but you may want to restrict
|
| 10 |
# access to your space to only authorized users. Uncomment the following line
|
| 11 |
-
# to
|
| 12 |
#
|
| 13 |
# ENV LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK=true
|
| 14 |
#
|
| 15 |
# Set secrets in your space to create an inital user, and log in with your
|
| 16 |
# provided username and password. Do not set these in your Dockerfile, as they
|
| 17 |
-
#
|
| 18 |
#
|
| 19 |
# LABEL_STUDIO_USERNAME
|
| 20 |
# LABEL_STUDIO_PASSWORD
|
|
|
|
| 8 |
# will full access to all projects and data. This is great for trying out
|
| 9 |
# Label Studio and collaborating on projects, but you may want to restrict
|
| 10 |
# access to your space to only authorized users. Uncomment the following line
|
| 11 |
+
# to disable public account creation for this space.
|
| 12 |
#
|
| 13 |
# ENV LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK=true
|
| 14 |
#
|
| 15 |
# Set secrets in your space to create an inital user, and log in with your
|
| 16 |
# provided username and password. Do not set these in your Dockerfile, as they
|
| 17 |
+
# globally visible on a public space.
|
| 18 |
#
|
| 19 |
# LABEL_STUDIO_USERNAME
|
| 20 |
# LABEL_STUDIO_PASSWORD
|
README.md
CHANGED
|
@@ -1,11 +1,115 @@
|
|
| 1 |
---
|
| 2 |
title: LabelStudio
|
| 3 |
-
emoji:
|
| 4 |
colorFrom: yellow
|
| 5 |
colorTo: yellow
|
| 6 |
sdk: docker
|
| 7 |
-
pinned:
|
| 8 |
license: apache-2.0
|
| 9 |
---
|
|
|
|
| 10 |
|
| 11 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
title: LabelStudio
|
| 3 |
+
emoji: π§
|
| 4 |
colorFrom: yellow
|
| 5 |
colorTo: yellow
|
| 6 |
sdk: docker
|
| 7 |
+
pinned: true
|
| 8 |
license: apache-2.0
|
| 9 |
---
|
| 10 |
+
<img src="https://user-images.githubusercontent.com/12534576/192582340-4c9e4401-1fe6-4dbb-95bb-fdbba5493f61.png"/>
|
| 11 |
|
| 12 |
+
[Website](https://hubs.ly/Q01CNgsd0) β’ [Docs](https://hubs.ly/Q01CN9Yq0) β’ [12K+ GitHub βοΈ!](https://hubs.ly/Q01CNbPQ0) β’ [Slack Community](https://hubs.ly/Q01CNb9H0)
|
| 13 |
+
|
| 14 |
+
## What is Label Studio?
|
| 15 |
+
|
| 16 |
+
Label Studio is an open source data labeling platform. It lets you label audio,
|
| 17 |
+
text, images, videos, and time series data with a simple, straightforward, and
|
| 18 |
+
highly-configurable user interface. Label Studio can prepare new data or
|
| 19 |
+
improve existing training data to get more accurate ML models.
|
| 20 |
+
|
| 21 |
+
|
| 22 |
+
## Getting Started With Label Studio in Hugging Face Spaces
|
| 23 |
+
|
| 24 |
+
The Label Studio community is thrilled to offer Label Studio as a Hugging Face
|
| 25 |
+
Spaces application. You can try the data-annotation interface, connect popular
|
| 26 |
+
machine learning models, and share the application with collaborators. You can
|
| 27 |
+
start immediately by creating an account or replicate the space and work in
|
| 28 |
+
your own environment.
|
| 29 |
+
|
| 30 |
+
### Creating a Use Account and Logging In
|
| 31 |
+
|
| 32 |
+
Begin by creating a new account in the Label Studio space, then log in with your
|
| 33 |
+
credentials. By default, these spaces permit anyone to create a new login
|
| 34 |
+
account, allowing them to view and modify project configuration, data sets, and
|
| 35 |
+
annotations. Without any modifications, treat this space like a demo environment.
|
| 36 |
+
|
| 37 |
+
### Creating a Labeling Project
|
| 38 |
+
|
| 39 |
+
After logging in, Label Studio will present you with a project view. Here you
|
| 40 |
+
can create a new project with prompts to upload data and set up a custom
|
| 41 |
+
configuration interface.
|
| 42 |
+
|
| 43 |
+
Note that in the default configuration, storage is local and temporary. Any
|
| 44 |
+
projects, annotations, and configurations will be lost if the space is restarted.
|
| 45 |
+
|
| 46 |
+
### Next Steps and Additional Resources
|
| 47 |
+
|
| 48 |
+
To help with getting started, the Label Studio community curated a list of
|
| 49 |
+
resources including tutorials and documentation.
|
| 50 |
+
|
| 51 |
+
- π [Zero to One with Label Studio Tutorial](https://hubs.ly/Q01CN93R0)
|
| 52 |
+
- π [Try Label Studio Enterprise](https://hubs.ly/Q01CMLll0)
|
| 53 |
+
- π€ [Tutorial: Using Label Studio with Hugging Face Datasets Hub](https://danielvanstrien.xyz/huggingface/huggingface-datasets/annotation/full%20stack%20deep%20learning%20notes/2022/09/07/label-studio-annotations-hub.html)
|
| 54 |
+
- π‘ [Label Studio Docs](https://hubs.ly/Q01CN9Yq0)
|
| 55 |
+
|
| 56 |
+
|
| 57 |
+

|
| 58 |
+
|
| 59 |
+
Have a custom dataset? You can customize Label Studio to fit your needs. Read
|
| 60 |
+
an [introductory blog post](https://towardsdatascience.com/introducing-label-studio-a-swiss-army-knife-of-data-labeling-140c1be92881)
|
| 61 |
+
to learn more.
|
| 62 |
+
|
| 63 |
+
### Configuring Label Studio Spaces as a Production Environment
|
| 64 |
+
|
| 65 |
+
By default this space allows for the unrestricted creation of new accounts
|
| 66 |
+
will full access to all projects and data. This is great for trying out
|
| 67 |
+
Label Studio and collaborating on projects, but you may want to restrict
|
| 68 |
+
access to your space to only authorized users. Add the following environment
|
| 69 |
+
variable to your spaces Dockerfile to disable public account creation for
|
| 70 |
+
this space.
|
| 71 |
+
|
| 72 |
+
ENV LABEL_STUDIO_DISABLE_SIGNUP_WITHOUT_LINK=true
|
| 73 |
+
|
| 74 |
+
Set secrets in your space to create an inital user, and log in with your
|
| 75 |
+
provided username and password. Do not set these in your Dockerfile, as they
|
| 76 |
+
globally visible on a public space.
|
| 77 |
+
|
| 78 |
+
LABEL_STUDIO_USERNAME
|
| 79 |
+
LABEL_STUDIO_PASSWORD
|
| 80 |
+
|
| 81 |
+
You will need to provide new users with an invitation link to join the space,
|
| 82 |
+
which can be found in the Organizations interface of Label Studio
|
| 83 |
+
|
| 84 |
+
By default this space stores all project configuration and data annotations
|
| 85 |
+
in local storage with Sqlite. If the space is reset, all configuration and
|
| 86 |
+
annotation data in the space will be lost. You can enable configuration
|
| 87 |
+
persistence by connecting an external Postgres database to your space,
|
| 88 |
+
guaranteeing that all project and annotation settings are preserved.
|
| 89 |
+
|
| 90 |
+
Set the following secret variables to match your own hosted instance of
|
| 91 |
+
Postgres. We strongly recommend setting these as secrets to prevent leaking
|
| 92 |
+
information about your database service to the public in your spaces
|
| 93 |
+
definition.
|
| 94 |
+
|
| 95 |
+
ENV DJANGO_DB=default
|
| 96 |
+
ENV POSTGRE_NAME=<postgres_name>
|
| 97 |
+
ENV POSTGRE_PORT=<db_port>
|
| 98 |
+
ENV POSTGRE_USER=<postgres_user>
|
| 99 |
+
ENV POSTGRE_PASSWORD=<password>
|
| 100 |
+
ENV POSTGRE_PORT=<db_port>
|
| 101 |
+
ENV POSTGRE_HOST=<db_host>
|
| 102 |
+
|
| 103 |
+
Add the following environment variable to remove the warning about ephemeral
|
| 104 |
+
storage.
|
| 105 |
+
|
| 106 |
+
ENV STORAGE_PERSISTENCE=1
|
| 107 |
+
|
| 108 |
+
Note that you will need to connect cloud storage to host data items that you
|
| 109 |
+
want to annotate, as local storage will not be preserved across a space reset.
|
| 110 |
+
|
| 111 |
+
## Questions? Concerns? Want to get involved?
|
| 112 |
+
|
| 113 |
+
Email the community team at [[email protected]](mailto:[email protected])
|
| 114 |
+
|
| 115 |
+
</body>
|