framework for synchronous batch speech-to-text transcription using backends like AWS, Watson, etc.
Project description
py-transcribe-aws
AWS Transcribe implementation of py-transcribe
Python Installation
pip install py_transcribe_aws
Usage
Setting the implementation module path
Set ENV var TRANSCRIBE_MODULE_PATH
, e.g.
export TRANSCRIBE_MODULE_PATH=transcribe_aws
or pass the module path at service-creation time, e.g.
from transcribe import init_transcription_service
service = init_transcription_service(
module_path="transcribe_aws"
)
Basic usage
Your code generally should not need to access any of the implementations in this module directly. See py-transcribe for docs on usage of the framework.
ENV/config vars
The following config vars can be set in ENV or passed in code, e.g. init_transcription_service(config={})
TRANSCRIBE_AWS_REGION|AWS_REGION
(required)
The region hosting the S3 bucket to which source audio (or video) files will be uploaded for transcription
TRANSCRIBE_AWS_ACCESS_KEY_ID|AWS_ACCESS_KEY_ID
(required)
TRANSCRIBE_AWS_SECRET_ACCESS_KEY|AWS_SECRET_ACCESS_KEY
(required)
TRANSCRIBE_AWS_S3_BUCKET_SOURCE
(required)
Bucket where source will be uploaded and then passed to AWS Transcribe
AWS Permissions
The AWS IAM used must have permissions to read/write/delete from the configured source bucket and also use AWS Transcribe
TODO: give exact details on minimum permissions/policies.
Terraform module for setting up transcribe infrastructure
This repo includes a terraform module for setting up the necessary infrastructure to run transcribe.
You can include the terraform module, like this:
module "transcribe_aws" {
source = "git::https://github.com/ICTLearningSciences/py-transcribe-aws.git?ref=tags/{CHANGE_TO_LATEST_VERSION}"
transcribe_namespace = "YOUR_NAMESPACE"
}
...and then the module exposes all the (sensitive) env vars for running transcribe in an output map, which you can use like
resource "some_server_type" {
env = module.transcribe_aws.transcribe_env_vars
}
Development
Run tests during development with
make test-all
Once ready to release, create a release tag, currently using semver-ish numbering, e.g. 1.0.0(-alpha.1)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for py_transcribe_aws-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 989258197effa34a52bbb5e905f61082ae76eda763d619ace2b12d2f552eebee |
|
MD5 | ef556cfced756558b527e30a6f35c100 |
|
BLAKE2b-256 | a132ff003e709afd732f980a0ef38fd11657d3961f1fc45989331e9aae5a130f |