Java Transcription Starter
This sample demonstrates interacting with the Deepgram API from a Java server. It uses the Deepgram API with the NanoHTTPD Java package to handle API calls, and has a javascript client built from web components.
What is Deepgram?
Deepgram’s (opens in new tab) voice AI platform provides APIs for speech-to-text, text-to-speech, and full speech-to-speech voice agents. Over 200,000+ developers use Deepgram to build voice AI products and features.
Sign-up to Deepgram
Before you start, it's essential to generate a Deepgram API key to use in this project. Sign-up now for Deepgram and create an API key (opens in new tab).
Quickstart
Manual
Follow these steps to get started with this starter application.
Clone the repository
Go to GitHub and clone the repository (opens in new tab).
Install maven
Install maven on your system. Maven is a build automation tool used primarily for Java projects.
Here's how to install maven on Mac (opens in new tab) and Windows (opens in new tab).
If you use homebrew, you can install maven with the following command:
brew install maven
Install dependencies
Install the project dependencies in the root directory. You will see a target folder created with the compiled classes.
mvn compile
Edit the config file
Copy the text from .env-sample and create a new file called .env. Paste in the code and enter your API key you generated in the Deepgram console (opens in new tab).
port=8080
deepgram_api_key=api_key
Run the application
Once running, you can access the application in your browser (opens in new tab).
mvn exec:java -Dexec.mainClass="App"
Issue Reporting
If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Security Policy (opens in new tab) details the procedure for contacting Deepgram.
Getting Help
We love to hear from you so if you have questions, comments or find a bug in the project, let us know! You can either:
- Open an issue in this repository (opens in new tab)
- Join the Deepgram Github Discussions Community (opens in new tab)
- Join the Deepgram Discord Community (opens in new tab)
Author
License
This project is licensed under the MIT license. See the LICENSE (opens in new tab) file for more info.