{"id":26359110,"url":"https://github.com/assemblyai/assemblyai-go-sdk","last_synced_at":"2025-06-25T12:37:21.073Z","repository":{"id":207205177,"uuid":"712474861","full_name":"AssemblyAI/assemblyai-go-sdk","owner":"AssemblyAI","description":"Official Go SDK","archived":false,"fork":false,"pushed_at":"2024-04-16T09:48:42.000Z","size":5326,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-05-02T01:47:28.306Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AssemblyAI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-10-31T14:41:15.000Z","updated_at":"2024-05-17T22:23:40.168Z","dependencies_parsed_at":"2024-01-18T18:27:29.599Z","dependency_job_id":"6ffadbeb-5943-4304-ae79-1f046f480a6c","html_url":"https://github.com/AssemblyAI/assemblyai-go-sdk","commit_stats":null,"previous_names":["assemblyai/assemblyai-go-sdk"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AssemblyAI%2Fassemblyai-go-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AssemblyAI%2Fassemblyai-go-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AssemblyAI%2Fassemblyai-go-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AssemblyAI%2Fassemblyai-go-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AssemblyAI","download_url":"https://codeload.github.com/AssemblyAI/assemblyai-go-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243893856,"owners_count":20364916,"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":"2025-03-16T15:58:44.780Z","updated_at":"2025-06-25T12:37:21.062Z","avatar_url":"https://github.com/AssemblyAI.png","language":"Go","readme":"\u003cimg src=\"https://github.com/AssemblyAI/assemblyai-go-sdk/blob/main/assemblyai.png?raw=true\" width=\"500\"/\u003e\n\n---\n\n[![CI Passing](https://github.com/AssemblyAI/assemblyai-go-sdk/actions/workflows/go.yml/badge.svg)](https://github.com/AssemblyAI/assemblyai-go-sdk/actions/workflows/go.yml)\n[![GitHub License](https://img.shields.io/github/license/AssemblyAI/assemblyai-go-sdk)](https://github.com/AssemblyAI/assemblyai-go-sdk/blob/main/LICENSE)\n[![Go Reference](https://pkg.go.dev/badge/github.com/AssemblyAI/assemblyai-go-sdk.svg)](https://pkg.go.dev/github.com/AssemblyAI/assemblyai-go-sdk)\n[![AssemblyAI Twitter](https://img.shields.io/twitter/follow/AssemblyAI?label=%40AssemblyAI\u0026style=social)](https://twitter.com/AssemblyAI)\n[![AssemblyAI YouTube](https://img.shields.io/youtube/channel/subscribers/UCtatfZMf-8EkIwASXM4ts0A)](https://www.youtube.com/@AssemblyAI)\n[![Discord](https://img.shields.io/discord/875120158014853141?logo=discord\u0026label=Discord\u0026link=https%3A%2F%2Fdiscord.com%2Fchannels%2F875120158014853141\u0026style=social)\n](https://assemblyai.com/discord)\n\n# AssemblyAI Go SDK\n\n\u003e [!IMPORTANT]\n\u003e As of April 2025, AssemblyAI Go SDK **has been discontinued** and will no longer be maintained.\n\u003e\n\u003e While the SDK will no longer be updated, any previously published releases will remain available.\n\u003e\n\u003e Going forward, see the [AssemblyAI API reference](https://www.assemblyai.com/docs/api-reference) for information on how to integrate with our API directly. \n\u003e\n\u003e We know this is a disruptive change. If you need help with this transition, [reach out to our Support team](https://www.assemblyai.com/contact/support) and we'll help you in any way we can. \n\nA Go client library for accessing [AssemblyAI](https://assemblyai.com).\n\n## Overview\n\n- [AssemblyAI Go SDK](#assemblyai-go-sdk)\n    - [Overview](#overview)\n    - [Documentation](#documentation)\n    - [Quickstart](#quickstart)\n        - [Installation](#installation)\n        - [Examples](#examples)\n            - [Core Transcription](#core-transcription)\n            - [Audio Intelligence](#audio-intelligence)\n            - [Real-Time Transcription](#real-time-transcription)\n    - [Playgrounds](#playgrounds)\n    - [Tips and tricks](#tips-and-tricks)\n        - [Inspect API errors](#inspect-api-errors)\n\n## Documentation\n\nVisit our [AssemblyAI API Documentation](https://www.assemblyai.com/docs) to get an overview of our models!\n\nSee the reference docs at [pkg.go.dev](https://pkg.go.dev/github.com/AssemblyAI/assemblyai-go-sdk).\n\n## Quickstart\n\n### Installation\n\n```bash\ngo get github.com/AssemblyAI/assemblyai-go-sdk\n```\n\n### Examples\n\nBefore you begin, you need to have your API key. If you don't have one yet, [**sign up for one**](https://www.assemblyai.com/dashboard/signup)!\n\n#### Core Transcription\n\n\u003cdetails\u003e\n    \u003csummary\u003eTranscribe an audio file from URL\u003c/summary\u003e\n\n```go\npackage main\n\nimport (\n    \"context\"\n    \"log\"\n    \"os\"\n\n    \"github.com/AssemblyAI/assemblyai-go-sdk\"\n)\n\nfunc main() {\n    apiKey := os.Getenv(\"ASSEMBLYAI_API_KEY\")\n\n    ctx := context.Background()\n\n    audioURL := \"https://example.org/audio.mp3\"\n\n    client := assemblyai.NewClient(apiKey)\n\n    transcript, err := client.Transcripts.TranscribeFromURL(ctx, audioURL, nil)\n    if err != nil {\n        log.Fatal(\"Something bad happened:\", err)\n    }\n\n    log.Println(*transcript.Text)\n}\n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n    \u003csummary\u003eTranscribe a local audio file\u003c/summary\u003e\n\n```go\npackage main\n\nimport (\n    \"context\"\n    \"log\"\n    \"os\"\n\n    \"github.com/AssemblyAI/assemblyai-go-sdk\"\n)\n\nfunc main() {\n    apiKey := os.Getenv(\"ASSEMBLYAI_API_KEY\")\n\n    ctx := context.Background()\n\n    client := assemblyai.NewClient(apiKey)\n\n    f, err := os.Open(\"./my-local-audio-file.wav\")\n    if err != nil {\n        log.Fatal(\"Couldn't open audio file:\", err)\n    }\n    defer f.Close()\n\n    transcript, err := client.Transcripts.TranscribeFromReader(ctx, f, nil)\n    if err != nil {\n        log.Fatal(\"Something bad happened:\", err)\n    }\n\n    log.Println(*transcript.Text)\n}\n```\n\n\u003c/details\u003e\n\n#### Audio Intelligence\n\n\u003cdetails\u003e\n    \u003csummary\u003eIdentify entities in a transcript\u003c/summary\u003e\n\n```go\npackage main\n\nimport (\n    \"context\"\n    \"log\"\n    \"os\"\n\n    \"github.com/AssemblyAI/assemblyai-go-sdk\"\n)\n\nfunc main() {\n    apiKey := os.Getenv(\"ASSEMBLYAI_API_KEY\")\n\n    ctx := context.Background()\n\n    audioURL := \"https://example.org/audio.mp3\"\n\n    client := assemblyai.NewClient(apiKey)\n\n    opts := \u0026assemblyai.TranscriptParams{\n        EntityDetection: assemblyai.Bool(true),\n    }\n\n    transcript, err := client.Transcripts.TranscribeFromURL(ctx, audioURL, opts)\n    if err != nil {\n        log.Fatal(\"Something bad happened:\", err)\n    }\n\n    for _, entity := range transcript.Entities {\n        log.Println(*entity.Text)\n        log.Println(entity.EntityType)\n        log.Printf(\"Timestamp: %v - %v\", *entity.Start, *entity.End)\n    }\n}\n```\n\n\u003c/details\u003e\n\n#### Real-Time Transcription\n\nCheck out the [realtime](./examples/realtime) example.\n\n## Playgrounds\n\nVisit one of our Playgrounds:\n\n- [LeMUR Playground](https://www.assemblyai.com/playground/v2/source)\n- [Transcription Playground](https://www.assemblyai.com/playground)\n\n## Tips and tricks\n\n### Inspect API errors\n\nIf you receive an API error, you can inspect the HTTP response returned by the API for more details:\n\n```go\ntranscript, err := client.Transcripts.TranscribeFromURL(ctx, audioURL, nil)\nif err != nil {\n    var apierr aai.APIError\n    if errors.As(err, \u0026apierr) {\n        // apierr.Response is the *http.Response from the API call.\n        fmt.Println(apierr.Response.StatusCode)\n    } else {\n        // err is not an API error.\n    }\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fassemblyai%2Fassemblyai-go-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fassemblyai%2Fassemblyai-go-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fassemblyai%2Fassemblyai-go-sdk/lists"}