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