influxdb-client

What it is and what it does

influxdb-client is the official Python client for InfluxDB 2.x, providing APIs for both querying time-series data via Flux language and writing measurements via Line Protocol or Point objects. It wraps the InfluxDB 2.0 HTTP API and includes management operations for organizations, buckets, tasks, and authorizations. The library uses RxPY for reactive streaming support and integrates with Pandas DataFrames for data analysis workflows.

The client handles authentication via tokens, supports multiple output formats (CSV, raw data, flux_table structures, Pandas DataFrames), and provides configuration via files, environment variables, or direct parameters. It includes features like gzip compression, proxy configuration, nanosecond precision timestamps, SSL/mTLS support, and connection pooling. The library is in Beta status and actively maintained, supporting modern Python versions (3.7–3.12).

Use it for:

• Write sensor or application metrics to InfluxDB from Python applications for time-series monitoring and analysis.
• Query historical data using Flux language and retrieve results as Pandas DataFrames for data science workflows.
• Manage InfluxDB resources (buckets, users, tasks, authorizations) programmatically from Python scripts.
• Stream high-volume IoT or telemetry data efficiently using reactive observables and batched writes.
• Integrate InfluxDB with Jupyter notebooks for interactive time-series data exploration and visualization.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for querying and writing data to InfluxDB 2.x using Flux language and Line Protocol, with support for Pandas DataFrames and reactive streams.

Yes. This is the official, actively maintained client for InfluxDB 2.x with low install friction, permissive licensing, no known vulnerabilities, and broad Python version support. Install it if you are using InfluxDB 2.x or InfluxDB Cloud; if you are on InfluxDB 1.x or 3.x, use the version-specific client instead.

Install

influxdb-client on PyPI

pip install influxdb-client

uv add influxdb-client

poetry add influxdb-client

Installing influxdb-client

Before you install

Low install friction with a pure-wheel distribution. Actively maintained as of 2026-01-23 with 792 repository stars. Supports Python 3.7 through 3.12 and depends on four stable runtime libraries (reactivex, certifi, python-dateutil, urllib3).

License in practice

MIT license (permissive) means you can use this library in commercial and proprietary projects with minimal restrictions, provided you include the license notice.

Quickstart

pip install influxdb-client

from influxdb_client import InfluxDBClient, Point
from influxdb_client.client.write_api import SYNCHRONOUS

client = InfluxDBClient(url="http://localhost:8086", token="my-token", org="my-org")
write_api = client.write_api(write_options=SYNCHRONOUS)
p = Point("my_measurement").tag("location", "Prague").field("temperature", 25.3)
write_api.write(bucket="my-bucket", record=p)

Requires Python 3.7 or later and an accessible InfluxDB 2.x server instance with valid credentials (URL, token, organization).

Verify before relying

• Performance characteristics when handling large datasets or high-frequency writes compared to alternatives
• Whether optional ciso8601 dependency significantly improves date parsing in typical workloads
• Async/await support stability and when it should be preferred over synchronous writes

Package facts

Evidence: influxdb_client-1.50.0-py3-none-any.whl

Keywords: InfluxDB, InfluxDB Python Client

Tags

More Libraries packages