elastic-agent-client
A python implementation of an Elastic Agent Client
What it is and what it does
This is a Python implementation of an Elastic Agent client, designed to let Python code act as a component within the Elastic Agent framework. It uses gRPC to communicate with Elastic Agent, with protocol definitions and code generation handled via protobuf and grpcio-tools. The package is marked as a technical preview and requires Python 3.10 or later.
The typical workflow involves writing a Python script that imports the client library, packaging it as an executable component, and registering it with Elastic Agent via a spec file. The package handles the gRPC plumbing and protocol generation automatically, but you are responsible for implementing the actual component logic and integrating it into an Elastic Agent deployment.
Use it for:
- Build a custom Python-based data collector or input plugin for Elastic Agent.
- Integrate legacy Python applications or scripts as managed components within Elastic Agent.
- Develop a Python shipper or processor that communicates with Elastic Agent over gRPC.
- Create a test or monitoring component that reports metrics back to Elastic Agent.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
A Python client library for communicating with Elastic Agent, enabling Python-based components to integrate with the Elastic Agent framework via gRPC.
Yes, if you are building a Python component for Elastic Agent and can work within the technical preview status and proprietary license. The low install friction and active maintenance are favorable, but verify that the Elastic V2 license terms suit your use case and that you are comfortable with the preview maturity level.
Install
elastic-agent-client on PyPI
pip
pip install elastic-agent-clientuv
uv add elastic-agent-clientpoetry
poetry add elastic-agent-clientInstalling elastic-agent-client
Before you install
Low install friction with a pure-wheel distribution. Active maintenance with a recent release. Six runtime dependencies including grpcio and protobuf are well-established libraries.
License in practice
Licensed under Elastic V2, a proprietary license. The license treatment is unclear in the package metadata, so review the actual license terms before use in commercial or redistributed contexts.
Quickstart
pip install elastic-agent-client
from elastic_agent_client.client import Client
# Initialize and use the client to communicate with Elastic Agent
client = Client()
Requires Python 3.10 or later. Intended for use as a component binary within an Elastic Agent deployment, not as a standalone library.
Verify before relying
- Stability and production-readiness status beyond 'technical preview' designation in the description.
- Whether the gRPC protocol and generated code are stable across Elastic Agent versions.
- Specific use-case examples beyond the fake component shown in the description.
Package facts
| License | Elastic V2 (unclear) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 6 — ecs-logging, grpcio-tools, grpcio, protobuf, types-protobuf, uvloop |
| Maintenance | actively maintained — 28 days since the last release |
| First released | |
| Downloads | 144,035/month — #11,163 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: elastic_agent_client-0.0.2-py3-none-any.whl
Tags
More Monitoring packages
Wraps any iterable to display a real-time…
copyleft · top 100 on PyPI
opentelemetry-semantic-conventionsProvides generated Python code for…
permissive · top 100 on PyPI
opentelemetry-sdkProvides the reference implementation of the…
permissive · top 100 on PyPI
opentelemetry-apiProvides the abstract API and interfaces for…
permissive · top 100 on PyPI
opentelemetry-exporter-otlp-proto-httpExports OpenTelemetry observability data to an…
permissive · top 1,000 on PyPI
opentelemetry-instrumentationProvides automatic instrumentation commands and…
permissive · top 1,000 on PyPI
grpclibgrpclib is a pure-Python asyncio-based…
permissive · top 1,000 on PyPI
elastic-apmElastic APM is the official Python agent for…
permissive · top 5,000 on PyPI
elastic-transportProvides shared HTTP transport classes and…
permissive · top 1,000 on PyPI
tritonclienttritonclient is a Python client library for…
permissive · top 5,000 on PyPI
elasticsearch6Low-level Python client for Elasticsearch that…
permissive · top 15,000 on PyPI
grpcio-toolsGenerates Python gRPC service stubs and message…
permissive · top 1,000 on PyPI
opentelemetry-instrumentation-grpcAdds automatic tracing and monitoring to gRPC…
permissive · top 5,000 on PyPI
opentelemetry-exporter-otlp-proto-grpcExports telemetry data from Python applications…
permissive · top 1,000 on PyPI
elasticsearchOfficial Python client library for connecting…
permissive · top 1,000 on PyPI