Skip to content

Latest commit

 

History

History
 
 

sound-spleeter

README.md

singnetlogo

Sound Spleeter

This service uses Spleeter to perform source separation on audio files.

It is part of our third party DNN Model Services.

Getting Started

Requirements

Development

Clone this repository:

$ git clone https://github.com/singnet/dnn-model-services.git
$ cd dnn-model-services/services/sound-spleeter

Running the service:

To get the ORGANIZATION_ID and SERVICE_ID you must have already published a service (check this link).

Create the SNET Daemon's config JSON file (snetd.config.json).

{
   "DAEMON_END_POINT": "DAEMON_HOST:DAEMON_PORT",
   "IPFS_END_POINT": "http://ipfs.singularitynet.io:80",
   "BLOCKCHAIN_NETWORK_SELECTED": "BLOCKCHAIN_NETWORK",
   "PASSTHROUGH_ENDPOINT": "http://SERVICE_GRPC_HOST:SERVICE_GRPC_PORT",  
   "ORGANIZATION_ID": "ORGANIZATION_ID",
   "SERVICE_ID": "SERVICE_ID",
   "LOG": {
       "LEVEL": "debug",
       "OUTPUT": {
            "TYPE": "stdout"
           }
   }
}

For example (using the Ropsten testnet):

$ cat snetd.config.json
{
   "DAEMON_END_POINT": "0.0.0.0:7055",
   "IPFS_END_POINT": "http://ipfs.singularitynet.io:80",
   "BLOCKCHAIN_NETWORK_SELECTED": "ropsten",
   "PASSTHROUGH_ENDPOINT": "http://localhost:7003",
   "ORGANIZATION_ID": "snet",
   "SERVICE_ID": "sound-spleeter",
   "LOG": {
       "LEVEL": "debug",
       "OUTPUT": {
           "TYPE": "stdout"
           }
   }
}

Note that we set DAEMON_HOST = 0.0.0.0 because this service will run inside a Docker container.

Install all dependencies:

$ pip3 install -r requirements.txt

Generate the gRPC codes:

$ sh buildproto.sh

Start the service and SNET Daemon:

$ python3 run_service.py

Calling the service:

Inputs:

  • url: An audio file URL.

Local (testing purpose):

$ python3 test_service.py
Endpoint (localhost:7003):
Audio (URL): https://bh.singularitynet.io:7000/Resources/audio_example.mp3
{'vocals': '...', 'accomp': '...'}

Through SingularityNET (follow this link to learn how to publish a service and open a payment channel to be able to call it):

Assuming that you have an open channel to this service:

$ snet client call snet sound-spleeter default_group spleeter '{"audio_url": "https://bh.singularitynet.io:7000/Resources/audio_example.mp3"}'
...
Read call params from cmdline...

Calling service...

    response:
        value: '{'vocals': '...', 'accomp': '...'}'

Contributing and Reporting Issues

Please read our guidelines before submitting an issue. If your issue is a bug, please use the bug template pre-populated here. For feature requests and queries you can use this template.

Authors