{"id":13715879,"url":"https://github.com/milvus-io/milvus-sdk-java","last_synced_at":"2026-04-02T23:33:24.544Z","repository":{"id":38984793,"uuid":"213633271","full_name":"milvus-io/milvus-sdk-java","owner":"milvus-io","description":"Java SDK for Milvus.","archived":false,"fork":false,"pushed_at":"2025-05-07T04:45:29.000Z","size":11768,"stargazers_count":426,"open_issues_count":36,"forks_count":172,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-07T05:28:22.689Z","etag":null,"topics":["anns","java","milvus","sdk","vector"],"latest_commit_sha":null,"homepage":"https://milvus.io","language":"Java","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/milvus-io.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-08T12:15:26.000Z","updated_at":"2025-05-07T04:44:53.000Z","dependencies_parsed_at":"2024-01-15T11:04:32.833Z","dependency_job_id":"1177ce43-9fc3-4c52-86f6-e590cf0aec60","html_url":"https://github.com/milvus-io/milvus-sdk-java","commit_stats":null,"previous_names":[],"tags_count":69,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milvus-io%2Fmilvus-sdk-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milvus-io%2Fmilvus-sdk-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milvus-io%2Fmilvus-sdk-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/milvus-io%2Fmilvus-sdk-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/milvus-io","download_url":"https://codeload.github.com/milvus-io/milvus-sdk-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252823001,"owners_count":21809700,"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":["anns","java","milvus","sdk","vector"],"created_at":"2024-08-03T00:01:04.655Z","updated_at":"2026-04-02T23:33:24.536Z","avatar_url":"https://github.com/milvus-io.png","language":"Java","readme":"# Milvus Java SDK\n\n[![Maven Central](https://img.shields.io/maven-central/v/io.milvus/milvus-sdk-java.svg)](https://search.maven.org/artifact/io.milvus/milvus-sdk-java/)\n\nJava SDK for [Milvus](https://github.com/milvus-io/milvus). To contribute to this project, please read our [contribution guidelines](https://github.com/milvus-io/milvus/blob/master/CONTRIBUTING.md) first.\n\n## Getting started\n\n### Prerequisites\n\n    -   Java 8 or higher\n    -   Apache Maven or Gradle\n\nThe following table shows compatibilities between Milvus and Java SDK.\n\n| Milvus version | Java SDK version |\n|:--------------:|:----------------:|\n|      2.0       |      2.0.4       |\n|      2.1       |   2.1.0-beta4    |\n| 2.2.0 ~ 2.2.8  |  2.2.0 ~ 2.2.5   |\n|    \u003e= 2.2.9    |  2.2.7 ~ 2.2.15  |\n|     2.3.x      |      2.3.11      |\n|     2.4.x      |      2.4.11      |\n|     2.5.x      |      2.5.15      |\n|     2.6.x      |      2.6.17      |\n\n### Install Java SDK\n\nYou can use **Apache Maven** or **Gradle** add Milvus SDK to your project.\n\n   - Apache Maven\n\n       ```xml\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.milvus\u003c/groupId\u003e\n            \u003cartifactId\u003emilvus-sdk-java\u003c/artifactId\u003e\n            \u003cversion\u003e2.6.17\u003c/version\u003e\n        \u003c/dependency\u003e\n       ```\n\n   - Gradle/Groovy\n\n        ```groovy\n        implementation 'io.milvus:milvus-sdk-java:2.6.17'\n        ```\n\n   - Gradle/Kotlin\n\n        ```kotlin\n        implementation(\"io.milvus:milvus-sdk-java:2.6.17\")\n        ```\n  \nFrom v2.5.2, milvus Java SDK is split into two packages: milvus-sdk-java and milvus-sdk-java-bulkwriter, because BulkWriter requires quite a lot of dependencies. If you don't need BulkWriter tool, you can ignore the milvus-sdk-java-bulkwriter package.\nTo use BulkWriter, import milvus-sdk-java-bulkwriter to your project.\n\n   - Apache Maven\n\n    ```xml\n     \u003cdependency\u003e\n         \u003cgroupId\u003eio.milvus\u003c/groupId\u003e\n         \u003cartifactId\u003emilvus-sdk-java-bulkwriter\u003c/artifactId\u003e\n         \u003cversion\u003e2.6.17\u003c/version\u003e\n     \u003c/dependency\u003e\n    ```\n\n   - Gradle/Groovy\n\n     ```groovy\n     implementation 'io.milvus:milvus-sdk-java-bulkwriter:2.6.17'\n     ```\n\n   - Gradle/Kotlin\n\n     ```kotlin\n     implementation(\"io.milvus:milvus-sdk-java-bulkwriter:2.6.17\")\n     ```     \n\n### Examples\n\nPlease refer to [examples](https://github.com/milvus-io/milvus-sdk-java/tree/master/examples) folder for Java SDK examples.\n\n### Documentation\n\n\n\n### Troubleshooting\n\n- If you encounter the following error when running your application:\n    ```\n    Exception in thread \"main\" java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory\n    ```\n  This is because SLF4J jar files need to be added into your application's classpath. SLF4J is required by Java SDK for logging purpose.\n  \n  To fix this issue, you can use **Apache Maven** or **Gradle** to download the required jar files.\n                                                                                                         \n    - Apache Maven\n    \n        ```xml\n         \u003cdependency\u003e\n             \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n             \u003cartifactId\u003eslf4j-api\u003c/artifactId\u003e\n             \u003cversion\u003e1.7.30\u003c/version\u003e\n         \u003c/dependency\u003e\n        ```\n    \n    - Gradle/Groovy\n    \n         ```groovy\n         compile group: 'org.slf4j', name: 'slf4j-api', version: '1.7.30'\n         ```\n    - Gradle/Kotlin\n    \n        ```kotlin\n        implementation(\"org.slf4j:slf4j-api:1.7.30\")\n        ```\n\n### Development\n\nFor developers interested in contributing to the Milvus Java SDK, please refer to our [DEVELOPMENT.md](DEVELOPMENT.md) file. This document provides detailed instructions on:\n\n- Setting up your development environment\n- Cloning the repository\n- Building the SDK\n- Updating Milvus proto files\n- Running tests\n- Contributing guidelines\n\nWe welcome contributions from the community!","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmilvus-io%2Fmilvus-sdk-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmilvus-io%2Fmilvus-sdk-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmilvus-io%2Fmilvus-sdk-java/lists"}