https://github.com/elastic/elasticsearch-ruby

Ruby integrations for Elasticsearch
https://github.com/elastic/elasticsearch-ruby

Keywords

client elastic elasticsearch ruby rubynlp search

Keywords from Contributors

activerecord activejob mvc rubygem rspec crash-reporting rack activemodel rubocop code-formatter

Last synced: about 18 hours ago
JSON representation

Repository metadata

Ruby integrations for Elasticsearch

Host: GitHub
URL: https://github.com/elastic/elasticsearch-ruby
Owner: elastic
License: apache-2.0
Created: 2013-05-03T07:39:25.000Z (almost 13 years ago)
Default Branch: main
Last Pushed: 2026-02-27T10:26:39.000Z (4 days ago)
Last Synced: 2026-03-02T09:40:09.154Z (1 day ago)
Topics: client, elastic, elasticsearch, ruby, rubynlp, search
Language: Ruby
Homepage: https://www.elastic.co/docs/reference/elasticsearch/clients/ruby
Size: 18.1 MB
Stars: 1,978
Watchers: 345
Forks: 618
Open Issues: 10
Releases: 109
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT
- Notice: NOTICE

Elasticsearch

Download the latest version of Elasticsearch
or
sign-up
for a free trial of Elastic Cloud.

This repository contains the official Elasticsearch Ruby client. The elasticsearch gem is a complete Elasticsearch client which uses two separate libraries:

elastic-transport - provides the low-level code for connecting to an Elasticsearch cluster.
elasticsearch-api - provides a Ruby API for the Elasticsearch RESTful API.

Documentation

Please refer to
the full documentation on elastic.co
for comprehensive information.

Both elastic-transport and elasticsearch-api are documented. You can check
the elastic-transport
and the elasticsearch-api
documentation at RubyDocs.

Installation

gem install elasticsearch

Refer to the Installation section
of the getting started documentation.

Connecting

Refer to the Connecting section
of the getting started documentation.

Usage

require 'elasticsearch'
client = Elasticsearch::Client.new(host: 'https://my-elasticsearch-host.example')
client.ping
client.search(q: 'test')

Refer to the official documentation
for examples of how to use the most frequently called APIs and
doc/examples
for some practical examples.

For optimal performance, you should use a HTTP library which supports persistent ("keep-alive") connections, e.g. Patron or Typhoeus. These libraries are not dependencies of the Elasticsearch gems. Ensure you define a dependency for a HTTP library in your own application.

Check out these other official Ruby libraries for working with Elasticsearch:

elasticsearch-rails - integration with Ruby models and Rails applications.
elasticsearch-extensions, deprecated.
elasticsearch-dsl which provides a Ruby API for the Elasticsearch Query DSL.

Please see their respective READMEs for information and documentation.

Compatibility

We follow Ruby’s own maintenance policy and officially support all currently maintained versions per Ruby Maintenance Branches.

Language clients are forward compatible; meaning that clients support communicating with greater or equal minor versions of Elasticsearch without breaking.
It does not mean that the client automatically supports new features of newer Elasticsearch versions; it is only possible after a release of a new client version.
For example, a 8.12 client version won't automatically support the new features of the 8.13 version of Elasticsearch, the 8.13 client version is required for that.
Elasticsearch language clients are only backwards compatible with default distributions and without guarantees made.

Gem Version		Elasticsearch Version	Supported
8.x	→	8.x	8.x
9.x	→	9.x	9.x
main	→	main

Try Elasticsearch and Kibana locally

If you want to try Elasticsearch and Kibana locally, you can run the following command:

curl -fsSL https://elastic.co/start-local | sh

This will run Elasticsearch at http://localhost:9200 and Kibana at http://localhost:5601 using Docker.

More information is available here.

Development

See CONTRIBUTING.

License

This software is licensed under the Apache 2 license. See NOTICE.

Owner metadata

Name: elastic
Login: elastic
Email: info@elastic.co
Kind: organization
Description:
Website: https://www.elastic.co/
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/6764390?v=4
Repositories: 858
Last ynced at: 2025-10-28T00:29:28.877Z
Profile URL: https://github.com/elastic

GitHub Events

Total

Fork event: 21
Create event: 267
Commit comment event: 1
Release event: 13
Issues event: 8
Watch event: 29
Delete event: 214
Issue comment event: 199
Public event: 1
Push event: 692
Pull request review comment event: 13
Pull request review event: 65
Pull request event: 490

Last Year

Create event: 211
Commit comment event: 1
Release event: 12
Issues event: 7
Watch event: 16
Delete event: 162
Issue comment event: 145
Push event: 530
Pull request review comment event: 14
Pull request review event: 53
Pull request event: 390
Fork event: 9

Committers metadata

Last synced: about 18 hours ago

Total Commits: 3,443
Total Committers: 172
Avg Commits per committer: 20.017
Development Distribution Score (DDS): 0.499

Commits in past year: 206
Committers in past year: 8
Avg Commits per committer in past year: 25.75
Development Distribution Score (DDS) in past year: 0.073

Name	Email	Commits
Fernando Briano	f**o@p**t	1724
Karel Minarik	k**k@e**m	945
Emily Stolfo	e**o@g**m	433
Elastic Machine	e****e	32
Karel Minarik	k**k@e**o	30
István Zoltán Szabó	s**e@g**m	15
Colleen McGinnis	c**s@e**o	9
Joao Duarte	j**e@g**m	9
Karel Minarik	k**i@e**o	8
shields	j**s@g**m	7
Eugene Pirogov	i**e@g**m	6
dx7	r**7@g**m	5
Stephen Prater	me@s****m	5
Kevin Kirsche	K**b@g**m	5
Philip Krauss	p**p@p**t	4
Hiroshi Hatake	h**e@c**m	4
Chris Koehnke	c**e@e**o	4
Haruki Hasegawa	h**0@g**m	4
Christos Trochalakis	y**i@i**r	4
Andrew Cholakian	a**w@a**m	4
Adam Fernung	a**n@g**m	4
Jon Dalberg	j**g@t**m	3
Tobias Pfeiffer	p**b@g**m	3
Trevor Creech	t**r@o**m	3
Marci W	3****w	3
Mark Dodwell	m****c	3
Aaron Rustad	a**d@a**m	2
Joseph (Jy) Yaworski	j**i@c**s	2
Jan Calanog	n**g@g**m	2
kares	s**f@k**g	2
and 142 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 34
Total pull requests: 1,172
Average time to close issues: about 1 year
Average time to close pull requests: 2 days
Total issue authors: 22
Total pull request authors: 23
Average comments per issue: 2.47
Average comments per pull request: 0.62
Merged pull request: 951
Bot issues: 0
Bot pull requests: 3

Past year issues: 3
Past year pull requests: 371
Past year average time to close issues: about 2 months
Past year average time to close pull requests: about 24 hours
Past year issue authors: 3
Past year pull request authors: 10
Past year average comments per issue: 2.0
Past year average comments per pull request: 0.53
Past year merged pull request: 291
Past year bot issues: 0
Past year bot pull requests: 1

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/elastic/elasticsearch-ruby

Top Issue Authors

picandocodigo (12)
Bhumika2015 (2)
rful011 (1)
bkmgit (1)
denisj (1)
papanikge (1)
Sinjo (1)
elasticmachine (1)
felixstackadapt (1)
rafaltrojanowski (1)
harikrishnaapc (1)
ClearlyClaire (1)
giovannelli (1)
tye-singwa (1)
dbackeus (1)

Top Pull Request Authors

picandocodigo (756)
elasticmachine (334)
colleenmcginnis (18)
szabosteve (16)
marciw (8)
estolfo (6)
jrodewig (5)
Mpdreamz (5)
Earlopain (3)
reakaleek (3)
elastic-renovate-prod[bot] (2)
cotti (2)
rafaltrojanowski (2)
KOTungseth (2)
pquentin (2)

Top Issue Labels

Skipped tests (6)
8.0 (5)
question (5)
CI (4)
test-runner (3)
7.16 (3)
feature request (2)
waiting (1)
elasticsearch-extensions (1)
elasticsearch-api (1)
bug (1)
9.x (1)
investigation (1)
backport (1)
8.x (1)

Top Pull Request Labels

9.x (208)
elasticsearch-api (199)
CI (187)
8.x (178)
documentation (175)
backport (104)
test-runner (76)
elasticsearch-gem (27)
Skipped tests (24)
7.17 (17)
release-branch (16)
test (10)
bug (10)
feature (2)
dependencies (1)
major (1)

Package metadata

Total packages: 13
Total downloads:
- rubygems: 1,205,462,861 total
Total docker downloads: 4,817,494,156
Total dependent packages: 241 (may contain duplicates)
Total dependent repositories: 20,318 (may contain duplicates)
Total versions: 1,257
Total maintainers: 6

gem.coop: elasticsearch-api

Ruby API for Elasticsearch. See the `elasticsearch` gem for full integration.

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-api/
Licenses: Apache-2.0
Latest release: 9.3.0 (published 28 days ago)
Last Synced: 2026-03-01T20:02:42.010Z (1 day ago)
Versions: 156
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 202,078,015 Total
Docker Downloads: 795,729,980
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.06%
- Docker downloads count: 0.118%
- Downloads: 0.122%
Maintainers (4)

gem.coop: elasticsearch

Ruby integrations for Elasticsearch (client, API, etc.)

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch/
Licenses: Apache-2.0
Latest release: 9.3.0 (published 28 days ago)
Last Synced: 2026-03-02T08:21:13.264Z (1 day ago)
Versions: 157
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 201,198,889 Total
Docker Downloads: 795,729,980
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.06%
- Docker downloads count: 0.118%
- Downloads: 0.122%
Maintainers (4)

gem.coop: elasticsearch-transport

Ruby client for Elasticsearch. See the `elasticsearch` gem for full integration.

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.16/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-transport/
Licenses: Apache-2.0
Latest release: 7.17.11 (published over 1 year ago)
Last Synced: 2026-03-02T03:33:31.789Z (1 day ago)
Versions: 106
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 167,339,512 Total
Docker Downloads: 737,775,218
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.068%
- Docker downloads count: 0.124%
- Downloads: 0.149%
Maintainers (3)

rubygems.org: elasticsearch

Ruby integrations for Elasticsearch (client, API, etc.)

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch/
Licenses: Apache-2.0
Latest release: 9.3.0 (published 28 days ago)
Last Synced: 2026-03-02T07:02:33.076Z (1 day ago)
Versions: 158
Dependent Packages: 197
Dependent Repositories: 6,815
Downloads: 201,195,076 Total
Docker Downloads: 795,729,980
Rankings:
- Downloads: 0.119%
- Docker downloads count: 0.14%
- Dependent packages count: 0.19%
- Dependent repos count: 0.39%
- Average: 0.489%
- Forks count: 0.921%
- Stargazers count: 1.176%
Maintainers (4)

gem.coop: elasticsearch-dsl

A Ruby DSL builder for Elasticsearch

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-dsl/
Licenses: Apache-2.0
Latest release: 0.1.10 (published over 4 years ago)
Last Synced: 2026-03-01T23:31:13.609Z (1 day ago)
Versions: 12
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 17,282,169 Total
Docker Downloads: 17,227,449
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.496%
- Downloads: 0.957%
- Docker downloads count: 1.028%
Maintainers (3)

gem.coop: elasticsearch-xpack

Ruby integrations for the X-Pack extensions for Elasticsearch

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.16/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-xpack/
Licenses: Apache-2.0
Latest release: 7.17.11 (published over 1 year ago)
Last Synced: 2026-03-02T08:21:12.234Z (1 day ago)
Versions: 57
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 3,284,875 Total
Docker Downloads: 62,277,243
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Docker downloads count: 0.594%
- Average: 0.624%
- Downloads: 1.904%
Maintainers (4)
- picandocodigo
- elastic
- EmStolfo
- karmi

gem.coop: elasticsearch-extensions

Extensions for the Elasticsearch Rubygem

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-extensions/
Licenses: Apache-2.0
Latest release: 0.0.33 (published about 5 years ago)
Last Synced: 2026-03-01T15:31:30.882Z (2 days ago)
Versions: 33
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 11,553,545 Total
Docker Downloads: 7,208
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.765%
- Downloads: 1.122%
- Docker downloads count: 1.937%
Maintainers (5)
- picandocodigo
- elastic
- EmStolfo
- karmi
- karelminarik

rubygems.org: elasticsearch-api

Ruby API for Elasticsearch. See the `elasticsearch` gem for full integration.

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-api/
Licenses: Apache-2.0
Latest release: 9.3.0 (published 28 days ago)
Last Synced: 2026-03-01T22:32:24.448Z (1 day ago)
Versions: 157
Dependent Packages: 8
Dependent Repositories: 6,256
Downloads: 202,082,233 Total
Docker Downloads: 795,729,980
Rankings:
- Downloads: 0.118%
- Docker downloads count: 0.14%
- Dependent repos count: 0.408%
- Average: 0.799%
- Forks count: 0.917%
- Stargazers count: 1.169%
- Dependent packages count: 2.044%
Maintainers (4)

rubygems.org: elasticsearch-transport

Ruby client for Elasticsearch. See the `elasticsearch` gem for full integration.

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.16/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-transport/
Licenses: Apache-2.0
Latest release: 7.17.11 (published over 1 year ago)
Last Synced: 2026-03-01T15:03:15.557Z (2 days ago)
Versions: 106
Dependent Packages: 6
Dependent Repositories: 6,177
Downloads: 167,326,994 Total
Docker Downloads: 737,775,218
Rankings:
- Downloads: 0.138%
- Docker downloads count: 0.152%
- Dependent repos count: 0.41%
- Average: 0.878%
- Forks count: 0.917%
- Stargazers count: 1.169%
- Dependent packages count: 2.484%
Maintainers (3)

rubygems.org: elasticsearch-extensions

Extensions for the Elasticsearch Rubygem

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-extensions/
Licenses: Apache-2.0
Latest release: 0.0.33 (published about 5 years ago)
Last Synced: 2026-03-01T14:31:43.269Z (2 days ago)
Versions: 33
Dependent Packages: 23
Dependent Repositories: 198
Downloads: 11,553,545 Total
Docker Downloads: 7,208
Rankings:
- Forks count: 0.912%
- Dependent packages count: 0.963%
- Downloads: 0.988%
- Stargazers count: 1.166%
- Average: 1.396%
- Docker downloads count: 2.17%
- Dependent repos count: 2.177%
Maintainers (5)
- picandocodigo
- elastic
- EmStolfo
- karmi
- karelminarik

rubygems.org: elasticsearch-dsl

A Ruby DSL builder for Elasticsearch

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-dsl/
Licenses: Apache-2.0
Latest release: 0.1.10 (published over 4 years ago)
Last Synced: 2026-03-02T05:02:50.442Z (1 day ago)
Versions: 12
Dependent Packages: 4
Dependent Repositories: 606
Downloads: 17,283,116 Total
Docker Downloads: 17,227,449
Rankings:
- Downloads: 0.895%
- Forks count: 0.912%
- Docker downloads count: 1.125%
- Stargazers count: 1.166%
- Dependent repos count: 1.435%
- Average: 1.472%
- Dependent packages count: 3.3%
Maintainers (3)

rubygems.org: elasticsearch-xpack

Ruby integrations for the X-Pack extensions for Elasticsearch

Homepage: https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/7.16/index.html
Documentation: http://www.rubydoc.info/gems/elasticsearch-xpack/
Licenses: Apache-2.0
Latest release: 7.17.11 (published over 1 year ago)
Last Synced: 2026-03-02T09:33:14.886Z (1 day ago)
Versions: 57
Dependent Packages: 3
Dependent Repositories: 266
Downloads: 3,284,892 Total
Docker Downloads: 62,277,243
Rankings:
- Docker downloads count: 0.709%
- Forks count: 0.915%
- Stargazers count: 1.165%
- Average: 1.788%
- Dependent repos count: 1.918%
- Downloads: 1.978%
- Dependent packages count: 4.044%
Maintainers (4)
- picandocodigo
- elastic
- EmStolfo
- karmi

proxy.golang.org: github.com/elastic/elasticsearch-ruby

Homepage:
Documentation: https://pkg.go.dev/github.com/elastic/elasticsearch-ruby#section-documentation
Licenses: apache-2.0
Latest release: v9.3.0+incompatible (published 28 days ago)
Last Synced: 2026-03-02T08:21:11.875Z (1 day ago)
Versions: 213
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Forks count: 1.165%
- Stargazers count: 1.515%
- Average: 5.764%
- Dependent packages count: 9.576%
- Dependent repos count: 10.802%

Dependencies

Gemfile rubygems

byebug >= 0 development
rspec >= 0 development
ansi >= 0
cane >= 0
mocha >= 0
pry >= 0
rake >= 0
require-prof >= 0
rubocop >= 0
ruby-prof >= 0
shoulda-context >= 0
simplecov >= 0
test-unit ~> 2
yard >= 0

docs/examples/apm/Gemfile rubygems

elastic-apm >= 0
elasticsearch >= 0
sinatra >= 0

docs/examples/rabbitmq/Gemfile rubygems

bunny >= 0
elasticsearch >= 0
multi_json >= 0
oj >= 0

elasticsearch/elasticsearch.gemspec rubygems

bundler >= 0 development
pry >= 0 development
rake >= 0 development
rspec >= 0 development
simplecov >= 0 development
webmock >= 0 development
yard >= 0 development
elastic-transport ~> 8
elasticsearch-api = 8.4.0

elasticsearch-api/Gemfile rubygems

pry-byebug >= 0 development
pry-nav >= 0 development
rspec >= 0 development
rspec_junit_formatter >= 0 development

elasticsearch-api/elasticsearch-api.gemspec rubygems

activesupport >= 0 development
ansi >= 0 development
bundler >= 0 development
cane >= 0 development
elasticsearch >= 0 development
hashie >= 0 development
jbuilder < 7.0.0 development
jbuilder >= 0 development
jsonify >= 0 development
minitest >= 0 development
minitest-reporters >= 0 development
mocha >= 0 development
pry >= 0 development
rake >= 0 development
shoulda-context >= 0 development
simplecov >= 0 development
test-unit ~> 2 development
yard >= 0 development
multi_json >= 0

.github/workflows/license.yml actions

actions/checkout v2 composite
ruby/setup-ruby v1 composite

.github/workflows/main.yml actions

actions/checkout v2 composite
elastic/elastic-github-actions/elasticsearch master composite
ruby/setup-ruby v1 composite

.buildkite/Dockerfile docker

ruby $RUBY_VERSION build

docs/examples/apm/docker-compose.yml docker

docker.elastic.co/apm/apm-server ${STACK_VERSION}
docker.elastic.co/elasticsearch/elasticsearch ${STACK_VERSION}
docker.elastic.co/kibana/kibana ${STACK_VERSION}

docs/examples/apm/dockerfiles/pinger/Dockerfile docker

ruby 2.7 build

docs/examples/apm/dockerfiles/ruby/Dockerfile docker

ruby 2.7 build

.github/workflows/docs-build.yml actions

elasticsearch/Gemfile rubygems

elastic-transport >= 0

.github/workflows/docs-cleanup.yml actions

.github/workflows/otel.yml actions

actions/checkout v4.3.0 composite
elastic/elastic-github-actions/elasticsearch master composite
ruby/setup-ruby v1.263.0 composite

Score: 35.26122702743215