The olivere/elastic repository is a Go client library for Elasticsearch that enables developers to interact with Elasticsearch clusters from Go applications. The project is now deprecated, with the official recommendation to use the Elasticsearch client maintained at github.com/elastic/go-elasticsearch instead. However, the repository remains historically significant as a widely-used community implementation that has been in production use since 2012.
The library provides comprehensive coverage of Elasticsearch APIs across multiple functional areas. Document APIs are fully implemented, including Index, Get, Delete, Update, Bulk, and Reindex operations. Search APIs are extensively supported with implementations for standard search, search templates, multi-search, count, validation, explain, and profile operations. The library also includes support for various suggester types including term, phrase, completion, and context suggesters. Aggregations represent a major feature area with implementations spanning metrics aggregations like average, cardinality, percentiles, and stats; bucket aggregations including date histogram, terms, range, and geohash grid; and pipeline aggregations such as moving average, derivative, and bucket script operations.
The repository maintains version-specific branches aligned with Elasticsearch releases. Elastic 7.0 targets Elasticsearch 7.x, Elastic 6.0 targets Elasticsearch 6.x, and earlier versions support older Elasticsearch releases. The project recommends using Go modules for dependency management with version 7.0 or later. The README explicitly warns against using the development branch in production, directing users to stable release branches instead.
According to GitGenius activity tracking, the repository shows median issue and pull request response latency of 8190 hours with a mean of 16883.9 hours, indicating slower response times typical of mature projects with reduced active maintenance. The primary contributor tracked is olivere with 7 recorded events, followed by apgmckay and ljluestc with 3 events each. The repository shares overlapping contributors with major projects including microsoft/vscode, microsoft/typescript, and rust-lang/rust, suggesting it has attracted developers from significant open-source ecosystems.
The project emphasizes stability and production readiness, noting that Elastic has been used in production since 2012 across Elasticsearch versions from 0.90 through recent 7.x releases. Testing infrastructure was migrated to GitHub Actions, replacing the previously used Travis CI. The repository includes comprehensive documentation through its wiki, working examples, and recipe implementations demonstrating common patterns like bulk indexing and scrolling. The API status documentation shows extensive implementation coverage, though some X-pack features remain unimplemented. The project accepts pull requests for missing functionality and maintains that implementing missing pieces is straightforward for contributors.
