> ## Documentation Index
> Fetch the complete documentation index at: https://wiz-myvocal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Real-time SDKs — install

> Install the server-side Java, Go and Python SDKs for the MyVocal Speech to Text real-time API.

Server-side SDKs for the [Speech to Text real-time API](/guides/stt-realtime-quickstart). They are optional:
any language can call the REST and WebSocket API directly. They use the same API key, Characters balance
and History as the REST API.

| Language | Package | Runtime |
| - | - | - |
| Java | `ai.myvocal:myvocal-stt-realtime:1.0.0` | Java 8 or later (verified on 8, 11, 13, 17, 21); no Spring |
| Go | `github.com/MyVocal-AI/myvocal-stt-realtime-sdks/go` `v1.0.0`, package `sttrealtime` | Go 1.22 or later |
| Python | `myvocal-stt-realtime` `1.0.0` (blocking and `asyncio` clients) | Python 3.10 or later |

<Warning>
  Use the SDKs on your server only. The access key must never reach a browser or mobile app. For a
  browser client, call `createTicket` on your server and pass the single-use ticket to the browser.
  The SDKs themselves always connect with the access key.
</Warning>

## Install

Install 1.0.0 with the command for your language. Go is served by the Go module proxy (tag `go/v1.0.0`).
Python (wheel and sdist) and Java (JAR, sources, Javadoc and POM) are distributed as files on the
[GitHub Release v1.0.0](https://github.com/MyVocal-AI/myvocal-stt-realtime-sdks/releases/tag/v1.0.0),
together with release notes and `SHA256SUMS`. Source code:
[MyVocal-AI/myvocal-stt-realtime-sdks](https://github.com/MyVocal-AI/myvocal-stt-realtime-sdks) (Apache License 2.0).

<CodeGroup>
  ```bash Go theme={null}
  go get github.com/MyVocal-AI/myvocal-stt-realtime-sdks/go@v1.0.0
  ```

  ```bash Python theme={null}
  pip install https://github.com/MyVocal-AI/myvocal-stt-realtime-sdks/releases/download/v1.0.0/myvocal_stt_realtime-1.0.0-py3-none-any.whl
  ```

  ```bash Java theme={null}
  base=https://github.com/MyVocal-AI/myvocal-stt-realtime-sdks/releases/download/v1.0.0
  for f in myvocal-stt-realtime-1.0.0.jar myvocal-stt-realtime-1.0.0-sources.jar \
           myvocal-stt-realtime-1.0.0-javadoc.jar myvocal-stt-realtime-1.0.0.pom SHA256SUMS; do
    curl -fsSLO "$base/$f"
  done
  sha256sum --check --ignore-missing SHA256SUMS
  mvn install:install-file -Dfile=myvocal-stt-realtime-1.0.0.jar -DpomFile=myvocal-stt-realtime-1.0.0.pom \
      -Dsources=myvocal-stt-realtime-1.0.0-sources.jar -Djavadoc=myvocal-stt-realtime-1.0.0-javadoc.jar
  ```
</CodeGroup>

For Java, after installing the files into your local Maven repository, add the dependency:

```xml theme={null}
<dependency>
  <groupId>ai.myvocal</groupId>
  <artifactId>myvocal-stt-realtime</artifactId>
  <version>1.0.0</version>
</dependency>
```

Set `MYVOCAL_ACCESS_KEY` in the server environment. The default endpoint is `https://api.myvocal.ai`.

<a id="next-steps" />

## Send your first audio

Each language page starts with a complete example that streams a file and prints the transcript:

<CardGroup cols={3}>
  <Card title="Python" icon="python" href="/sdks/stt-realtime/python">Blocking and `asyncio` clients.</Card>
  <Card title="Java" icon="java" href="/sdks/stt-realtime/java">Blocking calls, `CompletableFuture` and listeners.</Card>
  <Card title="Go" icon="golang" href="/sdks/stt-realtime/go">`context.Context`, typed events and errors.</Card>
</CardGroup>

## Lifecycle, disconnects and errors

The SDK frames audio (about 100 ms per frame), tracks sample cursors, follows in-connection rotation and
ends the session when you call `finish`. The [behavior guide](/sdks/stt-realtime/behavior) covers `finish`
vs `close`, disconnects, pause and resume, events, errors and observed service behavior. It applies to all
three SDKs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.