update READMEs

README.md

@@ -6,7 +6,51 @@ colorTo: yellow
 sdk: docker
 pinned: false
 suggested_hardware: t4-medium
-duplicated_from: facebook/seamless_m4t
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Seamless Streaming demo
+## Running on HF spaces
+You can simply duplicate the space to run it.
+
+## Running locally
+### Install backend seamless_server dependencies
+
+`cd seamless-experiences/seamless_vc/seamless_server`
+
+If running for the first time, create conda environment:
+```
+conda create --name smlss_server python=3.8
+conda activate smlss_server
+pip install -r requirements.txt
+```
+
+### Install frontend streaming-react-app dependencies
+```
+conda install -c conda-forge nodejs
+cd streaming-react-app
+npm install
+npm run build  # this will create the dist/ folder
+```
+
+
+### Running the server
+
+The server can be run locally with uvicorn below.
+Run the server in dev mode:
+
+```
+uvicorn app_pubsub:app --reload --host localhost
+```
+
+Run the server in prod mode:
+
+```
+uvicorn app_pubsub:app --host 0.0.0.0
+```
+
+To enable additional logging from uvicorn pass `--log-level debug` or `--log-level trace`.
+
+
+### Debuging
+
+If you enable "Server Debug Flag" when starting streaming from the client, this enables extensive debug logging and it saves audio files in /debug folder. 

seamless_server/README.md

@@ -1,72 +0,0 @@
-# Seamless Streaming Server
-
-## Setting up the AWS server
-
-- Clone working AMI with things set up: https://us-west-2.console.aws.amazon.com/ec2/home?region=us-west-2#ImageDetails:imageId=ami-013fc3fb27faa03e5
-- This has the conda environment, repository, model etc set up so minimal install was required
-
-- Open port tunnelling via ssh so you can connect to the AWS server via localhost (gets around some security issues): e.g. `ssh -L 8000:localhost:8000 -L 3000:localhost:3000 -L 5173:localhost:5173 -i ~/.ssh/mduppes_devserver.pem  ec2-user@44.231.140.195`
-
-## Setting up the dev environment
-
-Clone the repo
-
-`cd seamless-experiences/seamless_vc/seamless_server`
-
-If running for the first time, create conda environment from the environment.yaml `conda env create -f environment.yml`
-(or if you are on Mac OS, replace `environment.yml` with `environment_mac.yml`)
-
-In each new terminal you use you will need to activate the conda environment:
-`conda activate smlss_server`
-
-Install dependencies with pip:
-`pip install -r requirements.txt`
-
-Install Meta-specific dependencies with the dedicated install script:
-`./scripts/update_meta_dependencies.sh`
-
-If needed, download and extract the latest model using the dedicated script:
-`./scripts/download_latest_models.sh`
-
-## Setting up the docker environment
-
-Alternatively we can build a docker image (for ease of deployment).
-
-1. Make sure github keys are loaded into ssh-agent. Copy over the keys into ~/.ssh/ then run `eval $(ssh-agent)`, then `ssh-add` to load the keys.
-2. Run `docker-compose build` if you just want to build the image. If you want to also run the server: `docker compose up --build`.
-3. Optionally to push the built docker image to ECR so it could be pulled into deployments: `./deploy.sh` 
-
-NOTE: Add your models to the ./models directory.
-
-# Running the v2 ("pubsub") server
-
-The pubsub server can be loaded with docker above or run locally with uvicorn below.
-Run the server in dev mode:
-
-```
-uvicorn app_pubsub:app --reload
-```
-
-Run the server in prod mode:
-
-```
-uvicorn app_pubsub:app --host 0.0.0.0
-```
-
-To enable additional logging from uvicorn pass `--log-level debug` or `--log-level trace`.
-
-## Running the frontend
-
-- For the v2 pubsub server, the frontend lives in the streaming-react-app root directory (not seamless_ui).
-
-## Updating the conda environment after changes to environment.yml
-
-Run this command to install/remove packages to match the current environment.yml file:
-
-`conda env update --prefix ./env --file environment.yml  --prune`
-
-See: https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html?highlight=sharing#updating-an-environment
-
-## Debuging
-
-If you enable "Server Debug Flag" when starting streaming from the client, this enables extensive debug logging and it saves audio files in /debug folder. test_no_silence.wav contains data with silence chunks removed.