Spaces:
Sleeping
Sleeping
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 |
+
![Gif of Label Studio annotating different types of data](https://raw.githubusercontent.com/heartexlabs/label-studio/master/images/annotation_examples.gif)
|
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 [community@labelstud.io](mailto:community@labelstud.io)
|
114 |
+
|
115 |
+
</body>
|