{"id":30865836,"url":"https://github.com/aws/aws-sdk-kotlin","last_synced_at":"2026-04-03T21:12:05.063Z","repository":{"id":37257677,"uuid":"121333316","full_name":"aws/aws-sdk-kotlin","owner":"aws","description":"Multiplatform AWS SDK for Kotlin","archived":false,"fork":false,"pushed_at":"2026-02-04T19:54:53.000Z","size":324787,"stargazers_count":482,"open_issues_count":61,"forks_count":55,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-02-05T07:39:50.893Z","etag":null,"topics":["aws","kotlin","multiplatform","sdk","webservice-client"],"latest_commit_sha":null,"homepage":"https://aws.amazon.com/sdk-for-kotlin/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-02-13T03:17:58.000Z","updated_at":"2026-02-04T19:54:20.000Z","dependencies_parsed_at":"2023-12-18T21:19:42.779Z","dependency_job_id":"14dd0765-4153-4e2c-adf6-84edcbbff1fb","html_url":"https://github.com/aws/aws-sdk-kotlin","commit_stats":{"total_commits":2033,"total_committers":23,"mean_commits":88.3913043478261,"dds":"0.42105263157894735","last_synced_commit":"470b16d231a5a132b86f1fdbea4f2e8a8bb1926e"},"previous_names":["aws/aws-sdk-kotlin","awslabs/aws-sdk-kotlin"],"tags_count":658,"template":false,"template_full_name":null,"purl":"pkg:github/aws/aws-sdk-kotlin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Faws-sdk-kotlin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Faws-sdk-kotlin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Faws-sdk-kotlin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Faws-sdk-kotlin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws","download_url":"https://codeload.github.com/aws/aws-sdk-kotlin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Faws-sdk-kotlin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29319236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T20:44:44.282Z","status":"ssl_error","status_checked_at":"2026-02-10T20:44:43.393Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws","kotlin","multiplatform","sdk","webservice-client"],"created_at":"2025-09-07T22:01:55.478Z","updated_at":"2026-02-10T22:01:20.141Z","avatar_url":"https://github.com/aws.png","language":"Kotlin","funding_links":[],"categories":["Kotlin"],"sub_categories":[],"readme":"# AWS SDK for Kotlin\n[![Apache 2 licensed][apache-badge]][apache-url] [![Maven][maven-badge]][maven-url]\n\n[apache-badge]: https://img.shields.io/badge/license-APACHE2-blue.svg\n[apache-url]: https://github.com/aws/aws-sdk-kotlin/blob/main/LICENSE\n\n\n[maven-badge]: https://img.shields.io/maven-central/v/aws.sdk.kotlin/s3.svg?label=Maven\n[maven-url]: https://search.maven.org/search?q=g:aws.sdk.kotlin\n\nThis repo contains the AWS SDK for Kotlin and its [public roadmap](https://github.com/aws/aws-sdk-kotlin/projects/2).\n\n## Getting Started\n\n* [SDK Homepage](https://aws.amazon.com/sdk-for-kotlin/)\n* [Developer Guide](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/home.html)\n* [API Reference](https://sdk.amazonaws.com/kotlin/api/latest/index.html)\n* [Samples](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin)\n\nSee the [Getting Started Guide](docs/GettingStarted.md) to learn how to use the AWS SDK for Kotlin in your program.\n\n## Feedback\n\nThe SDK uses **GitHub Issues** to track feature requests and issues with the SDK. In addition, we use **GitHub Projects**\nto provide a high level overview of our roadmap and the features we are actively working on.\n\nYou can provide feedback or report a bug by submitting an [issue](https://github.com/aws/aws-sdk-kotlin/issues/new/choose).\nThis is the preferred mechanism to give feedback so that other users can engage in the conversation, +1 issues, etc.\n\n## Contributing\n\nIf you are interested in contributing to the AWS SDK for Kotlin, please take a look at [CONTRIBUTING](CONTRIBUTING.md)\n\n## Versioning\n\nSee our [VERSIONING](VERSIONING.md) policy for how the SDK is versioned.\n\n## Development\n\n### Generate SDK(s)\n\nGenerated sources are not checked into the repository, you first have to generate the clients before you can build them.\nA [step-by-step guide](docs/generate-sdk.md) is available that demonstrates building the AWS DynamoDB service, or if \nyou have a good working knowledge of Gradle, see below:\n\n```sh\n./gradlew --no-daemon :codegen:sdk:bootstrap\n```\n\nNOTE: This task will respect the AWS services specified by project properties. See options below.\nNOTE: To re-run codegen for the same set of services multiple times add the `--rerun-tasks` flag.\n\n\nAfter generating the services you care about they are available to build:\n\ne.g.\n```sh\n./gradlew :services:lambda:build\n```\n\n\nWhere the task follows the pattern: `:services:SERVICE:build`\n\nTo see list of all projects run `./gradlew projects`\n\n##### Generating a single service\nSee the [Build Properties](#build-properties) below to specify this in a config file.\n\n```sh\n./gradlew --no-daemon -Paws.services=+lambda  :codegen:sdk:bootstrap\n```\n\n##### Testing Locally\nTesting generated services generally requires publishing artifacts (e.g. client-runtime) of `smithy-kotlin`, `aws-crt-kotlin`, and `aws-sdk-kotin` to maven local.\n\n#### Generating API Documentation\n\nAPI documentation is generated using [Dokka](http://kotlin.github.io/dokka) which is the official documentation tool maintained by JetBrains for documenting Kotlin code.\n\nUnlike Java, Kotlin uses its own [KDoc](https://kotlinlang.org/docs/kotlin-doc.html) format.\n\n\nTo generate API reference documentation for the AWS Kotlin SDK:\n\n\n```sh\n./gradlew --no-daemon --no-parallel dokkaHtmlMultiModule\n```\n\nThis will output HTML formatted documentation to `build/dokka/htmlMultiModule`\n\nNOTE: You currently need an HTTP server to view the documentation in browser locally. You can either use the builtin server in Intellij or use your favorite local server (e.g. `python3 -m http.server`). See [Kotlin/dokka#1795](https://github.com/Kotlin/dokka/issues/1795)\n\n### Build Properties\n\nYou can define a `local.properties` config file at the root of the project to modify build behavior. \n\n|Property|Description|\n|---|---|\n|`compositeProjects`|Specify paths to repos the SDK depends upon such as `smithy-kotlin`|\n|`aws.services`|Specify inclusions (+ prefix) and exclusions (- prefix) of service names to generate|\n|`aws.protocols`|Specify inclusions (+ prefix) and exclusions (- prefix) of AWS protocols to generate|\n\n#### Composite Projects\n\nDependencies of the SDK can be added as composite build such that multiple repos may appear as one\nholistic source project in the IDE.\n\n```ini\n# comma separated list of paths to `includeBuild()`\n# This is useful for local development of smithy-kotlin in particular \ncompositeProjects=../smithy-kotlin\n```\n\n#### Generating Specific Services Based on Name or Protocol\n\nA comma separated list of services to include or exclude for generation from codegen/sdk/aws-models may\nbe specified with the `aws.services` property. A list of protocols of services to generate may be specified\nwith the `aws.protocols` property.\n\nIncluded services require a '+' character prefix and excluded services require a '-' character. \nIf any items are specified for inclusion, only specified included members will be generated.  If no items\nare specified for inclusion, all members not excluded will be generated.\nWhen unspecified all services found in the directory specified by the `modelsDir` property are generated.\nService names match the filenames in the models directory `service.VERSION.json`.\n\nSome example entries for `local.properties`:\n```ini\n# Generate only AWS Lambda:\naws.services=+lambda\n```\n\n```ini\n# Generate all services but AWS location and AWS DynamoDB:\naws.services=-location,-dynamodb\n```\n\n```ini\n# Generate all services except those using the restJson1 protocol:\naws.protocols=-restJson1\n```\n\n### Debugging\n\nSee [Debugging](docs/debugging.md)\n\n## Security\n\nPlease refer to our [security policy](https://github.com/aws/aws-sdk-kotlin/security/policy).\n\n## Supported targets\n\nThe SDK supports the following targets:\n\n* [JVM](docs/targets.md#jvm)\n* [Android](docs/targets.md#android)\n* [GraalVM](docs/targets.md#graalvm)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws%2Faws-sdk-kotlin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws%2Faws-sdk-kotlin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws%2Faws-sdk-kotlin/lists"}