{"id":15044651,"url":"https://github.com/elastic/connectors","last_synced_at":"2025-05-15T07:05:41.947Z","repository":{"id":62223677,"uuid":"507855351","full_name":"elastic/connectors","owner":"elastic","description":"Official Elastic connectors for third-party data sources","archived":false,"fork":false,"pushed_at":"2025-05-13T13:32:50.000Z","size":7978,"stargazers_count":100,"open_issues_count":148,"forks_count":164,"subscribers_count":67,"default_branch":"main","last_synced_at":"2025-05-13T14:52:32.136Z","etag":null,"topics":["app-search","elastic","elastic-stack","elasticsearch","enterprise-search","workplace-search"],"latest_commit_sha":null,"homepage":"https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elastic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"docs/SECURITY.md","support":"docs/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-06-27T10:03:10.000Z","updated_at":"2025-05-12T11:19:23.000Z","dependencies_parsed_at":"2023-10-16T17:14:07.923Z","dependency_job_id":"f6f2e2ec-fdbb-4f91-922f-59f85c2cbc5e","html_url":"https://github.com/elastic/connectors","commit_stats":{"total_commits":1519,"total_committers":48,"mean_commits":"31.645833333333332","dds":0.8057932850559579,"last_synced_commit":"eb24eda4b600bac880d8f10b43addb7056727d52"},"previous_names":["elastic/connectors-python"],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fconnectors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fconnectors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fconnectors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elastic%2Fconnectors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elastic","download_url":"https://codeload.github.com/elastic/connectors/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253969341,"owners_count":21992267,"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":["app-search","elastic","elastic-stack","elasticsearch","enterprise-search","workplace-search"],"created_at":"2024-09-24T20:50:51.232Z","updated_at":"2025-05-15T07:05:36.939Z","avatar_url":"https://github.com/elastic.png","language":"Python","readme":"[![Build status](https://badge.buildkite.com/a1319036cb613e63515320f44b187cd233771715c811d3dc7a.svg?branch=main)](https://buildkite.com/elastic/connectors)\n# Elastic connectors\n\n\u003cimg width=\"250\" alt=\"search-icon\" src=\"https://github.com/elastic/connectors/assets/32779855/2f594d89-7369-4c49-994a-1d67eefce436\"\u003e\n\n## Connectors\n\nThis repository contains the source code for all Elastic connectors, developed by the Search team at Elastic.\nUse connectors to sync data from popular data sources to Elasticsearch.\n\nThese connectors are available to be self-managed on your own infrastructure.\n\n\u003e [!NOTE]  \n\u003e Managed connectors on Elastic Cloud Hosted are no longer available as of version 9.0.\n\nℹ️ For an overview of the steps involved in deploying connectors refer to [**Self-managed connectors**](https://www.elastic.co/guide/en/elasticsearch/reference/current/es-build-connector.html) in the official Elastic documentation.\n\nTo get started quickly with self-managed connectors using Docker Compose, check out this [README file](./scripts/stack/README.md).\n\n### Connector documentation\n\nThe main documentation for using connectors lives in the [Elastic docs](https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html).\nYou'll find the individual references for each connector there.\n\nFor everything to do with _developing_ connectors, you'll find that here in this repo.\n\n#### API documentation\n\nSince 8.12.0, you can manage connectors and sync jobs programmatically using APIs.\nRefer to the [Connector API documentation](https://www.elastic.co/docs/api/doc/elasticsearch/v8/group/endpoint-connector).\n\n#### Command-line interface\n\nLearn about our CLI tool in [`docs/CLI.md`](./docs/CLI.md).\n\n## Connector service code\n\nIn addition to the source code for individual connectors, this repo also contains the connector service code, which is used for tasks like running connectors, and managing scheduling, syncs, and cleanup.\nThis is shared code that is not used by individual connectors, but helps to coordinate and run a deployed instance/process.\n\n## Connector framework\n\nThis repo is also the home of the Elastic connector framework. This framework enables developers to build Elastic-supported self-managed connectors.\nThe framework implements common functionalities out of the box, so developers can focus on the logic specific to integrating their chosen data source.\n\nThe framework ensures compatibility, makes it easier for our team to review PRs, and help out in the development process. When you build using our framework, we provide a pathway for the connector to be officially supported by Elastic.\n\n## Running a self-managed stack\n\nThis repo provides a [set of scripts](./scripts/stack) to allow a user to set up a full Elasticsearch, Kibana, and Connectors service stack using Docker.\nThis is useful to get up and running with the Connectors framework with minimal effort, and provides a guided set of prompts for setup and configuration.\nFor more information, instructions, and options, see the [README file](./scripts/stack/README.md) in the stack folder.\n\n### Framework use cases\n\nThe framework serves two distinct, but related use cases:\n\n- Customizing an existing Elastic connector client\n- Building a new self-managed connector\n\n### Guides for using the framework\n\n- [Code of Conduct](https://www.elastic.co/community/codeofconduct)\n- [Getting Support](docs/SUPPORT.md)\n- [Releasing](docs/RELEASING.md)\n- [Developer guide](docs/DEVELOPING.md)\n- [Connectors Reference](docs/REFERENCE.md)\n- [Security Policy](docs/SECURITY.md)\n- [Elastic-internal guide](docs/INTERNAL.md)\n- [Connector Protocol](docs/CONNECTOR_PROTOCOL.md)\n- [Configuration](docs/CONFIG.md)\n- [Command line interface](docs/CLI.md)\n- [Contribution guide](docs/CONTRIBUTING.md)\n- [Upgrading](docs/UPGRADING.md)\n\n### Version compatibility with Elasticsearch\n\n\u003e [!NOTE]\n\u003e Version compatibility will not be checked if Elasticsearch is serverless.\n\nThe Connector will perform a version compatibility check with the configured Elasticsearch server on startup.\nIf the versions are incompatible, the Connector will terminate and output the incompatible versions in the shell.\nIf the versions are different but otherwise compatible, the Connector will output a warning in the shell but will continue operating.\n\nWe recommend running on the same version as Elasticsearch.\nHowever, if you want to hold back upgrading one or the other for any reason, use this table to determine if your versions will be compatible.\n\n| Situation                       | Example Connector Framework version | Example ES version | Outcome |\n|---------------------------------|-------------------------------------|--------------------| ------- |\n| Versions are the same.          | 8.15.1.0                            | 8.15.1             | 💚 OK      |\n| Connectors has a build version. | 8.15.1.3                            | 8.15.1             | 💚 OK      |\n| ES patch number is newer.       | 8.15.__0__.0                        | 8.15.__1__         | ⚠️ Logged warning      |\n| ES minor number is newer.       | 8.__14__.2.0                        | 8.__15__.0         | ⚠️ Logged warning      |\n| ES major number is newer.       | __8__.15.1.0                        | __9__.0.0          | 🚫 Fatal error      |\n| ES patch number is older.       | 8.15.__1__.0                        | 8.15.__0__         | ⚠️ Logged warning      |\n| ES minor number is older.       | 8.__15__.1.0                        | 8.__14__.2         | 🚫 Fatal error      |\n| ES major number is older.       | __9__.0.0.0                         | __8__.15.1         | 🚫 Fatal error      |\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felastic%2Fconnectors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felastic%2Fconnectors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felastic%2Fconnectors/lists"}