{"id":19120232,"url":"https://github.com/i4ds/stt-demo-platform","last_synced_at":"2026-06-04T10:30:16.409Z","repository":{"id":255685792,"uuid":"853329719","full_name":"i4Ds/stt-demo-platform","owner":"i4Ds","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-21T13:42:25.000Z","size":246,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-21T14:35:42.920Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/i4Ds.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-06T12:50:02.000Z","updated_at":"2025-01-21T13:42:28.000Z","dependencies_parsed_at":"2024-09-06T18:31:07.080Z","dependency_job_id":"5023a73b-69d0-42fc-b1e0-2e8caf15671f","html_url":"https://github.com/i4Ds/stt-demo-platform","commit_stats":null,"previous_names":["i4ds/stt-demo-platform"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i4Ds%2Fstt-demo-platform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i4Ds%2Fstt-demo-platform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i4Ds%2Fstt-demo-platform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/i4Ds%2Fstt-demo-platform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/i4Ds","download_url":"https://codeload.github.com/i4Ds/stt-demo-platform/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240177055,"owners_count":19760308,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T05:13:24.001Z","updated_at":"2026-06-04T10:30:16.370Z","avatar_url":"https://github.com/i4Ds.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# STT Demo Platform Services\n\nThis document provides instructions for managing the Speech-to-Text (STT) Demo Platform services on Ubuntu.\n\n## Overview\n\nThe STT Demo Platform consists of several interconnected services that work together to provide a comprehensive speech-to-text solution. The main components are:\n\n1. A Python-based backend running in an Anaconda environment, managed by systemd and the user `stt_service`.\n2. A frontend website running in a Docker container\n3. Nginx for port forwarding, configured at `/etc/nginx/sites-enabled/default`\n\n## Backend Services\n\nThree Python services work together to offer the long_api:\n\n1. **Transcription Service** (`whisper_transcribe/transcribe.py`)\n   - Continuously scans a folder for .mp3 files to transcribe\n   - Managed by `stt-transcribe.service`\n\n2. **Upload Service** (`whisper_transcribe/upload.py`)\n   - Provides a web interface for uploading .mp3 files to the server\n   - Managed by `stt-uploader.service`\n   - Accessible via [https://stt4sg.fhnw.ch/long_v3/](https://stt4sg.fhnw.ch/long_v3/)\n\n3. **Status Service** (`whisper_transcribe/status.py`)\n   - Offers a web interface to check transcription status\n   - Allows users to download transcriptions in various formats\n   - Managed by `stt-status.service`\n   - Accessible via [https://stt4sg.fhnw.ch/long_v3/status/](https://stt4sg.fhnw.ch/long_v3/status/)\n\n4. **Short Transcription Service** (`stt/app.py`)\n   - Provides a web interface for short transcriptions\n   - Managed by `stt.service`\n   - Accessible via [https://stt4sg.fhnw.ch/stt/](https://stt4sg.fhnw.ch/stt/)\n\n### Deployment\nThey are deployed by an user `stt_service`, have an conda enviroment `stt_env` and their deployment is managed by systemd.\nA helpful script for the deployment is `deploy.bash`, which automatically copies files to `/srv/` and changes the ownership to the user.\nHowever, containers and services have to be restarted manually.\n\n## Frontend\n\nThe main website is hosted in a Docker container:\n\n- Configuration: `stt-demo-platform/docker-compose.yml`\n- Source code: `stt-demo-platform/stt4sg-demo-app`\n- URL: [https://stt4sg.fhnw.ch/](https://stt4sg.fhnw.ch/)\n\n### Updating the Frontend\n\nTo make changes to the main website:\n\n1. Edit the files in `stt-demo-platform/stt4sg-demo-app`\n2. Rebuild the Docker container:\n   ```bash\n   sudo docker compose up -d --build frontend\n   ```\n\n## Managing Services\nYou can manage the STT services using systemd commands. For example:\n\n- Start a service: `sudo systemctl start stt-uploader.service`\n- Stop a service: `sudo systemctl stop stt-transcribe.service`\n- Restart a service: `sudo systemctl restart stt-status.service`\n- Check service status: `sudo systemctl status stt-uploader.service`\n\n### Checking Latest Logs\n\nTo view the most recent logs for a service in real-time:\n\n```bash\nsudo journalctl -u \u003cservice-name\u003e -f\n```\n\n### Editing a Service\n\n1. Edit the service file:\n   ```bash\n   sudo nano /etc/systemd/system/\u003cservice-name\u003e.service\n   ```\n2. After making changes, reload the systemd manager:\n   ```bash\n   sudo systemctl daemon-reload\n   ```\n3. Restart the service to apply changes:\n   ```bash\n   sudo systemctl restart \u003cservice-name\u003e\n   ```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi4ds%2Fstt-demo-platform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fi4ds%2Fstt-demo-platform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fi4ds%2Fstt-demo-platform/lists"}