Skip to content

Latest commit

 

History

History
129 lines (97 loc) · 4.39 KB

README.md

File metadata and controls

129 lines (97 loc) · 4.39 KB

Wordcab Python

📖 Transcribe and Summarize any business communication at scale with Wordcab's API


Wordcab is a transcription and summarization service that provides a simple API to summarize any audio, text, or JSON file.

It also includes compatibility with other transcripts platforms like: AssemblyAI Deepgram Rev.ai Otter.ai Sonix.ai

Getting started

You can learn more about Wordcab services and pricing on our website.

If you want to try out the API, you can signup for a free account and start using the API right away.

Requirements

  • OS:
    • Linux
    • Mac
    • Windows
  • Python:
    • Python 3.8+

Installation

You can install Wordcab Python via pip from PyPI:

$ pip install wordcab

Start using the API with any python script right away!

Usage

Start Summary full pipeline

import time
from wordcab import retrieve_job, retrieve_summary, start_summary
from wordcab.core_objects import AudioSource, GenericSource, InMemorySource


# Prepare your input source
## For a transcript stored as a .txt or .json file
source = GenericSource(filepath="path/to/file.txt")  # Or file.json
## For a transcript stored as an audio file
source = AudioSource(filepath="path/to/file.mp3")
## For a transcript already in memory
transcript = {"transcript": ["SPEAKER A: Hello.", "SPEAKER B: Hi."]}
source = InMemorySource(obj=transcript)

# Launch the Summarization job
job = start_summary(
	source_object=source,
	display_name="sample_txt",
	summary_type="narrative",
	summary_lens=[1, 3],
	tags=["sample", "text"],
)

# Wait for the job completion
while True:
	job = retrieve_job(job_name=job.job_name)
	if job.job_status == "SummaryComplete":
		break
	else:
		time.sleep(3)

# Get the summary id
summary_id = job.summary_details["summary_id"]
# Retrieve the summary
summary = retrieve_summary(summary_id=summary_id)

# Get the summary as a human-readable string
print(summary.get_formatted_summaries())

# Save the json object to a file
with open("wordcab_summary.json", "w") as f:
	f.write(summary)

Documentation

Please see the Documentation for more details.

Contributing

Contributions are very welcome. 🚀 To learn more, see the Contributor Guide.

License

  • Distributed under the terms of the Apache 2.0 License Badge

  • Wordcab Python SDK is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.