hogepodge commited on
Commit
222cee0
β€’
1 Parent(s): 37ff17e

Added README.md with information on how to get started

Browse files

Added README.md with information on how to get started, and fixed
typos in the Dockerfile

Files changed (2) hide show
  1. Dockerfile +2 -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 diable 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
- # globall visible on a public space.
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: false
8
  license: apache-2.0
9
  ---
 
10
 
11
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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>