NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4202 most downloaded on PyPI
Community Python client for InfluxDB 3.0
Last release 1 months ago
27 Aug 2026
Ships fairly regularly
a new release about every 2 months
Some releases are documented
notes for 24 of 41 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
42 releases · first in 2023
One column per quarter.
IPv6 addresses in server URLs must be enclosed in square brackets, for example, http://[2001:db8::1]:8086.
#217: Makes the writing API simpler and more consistent with other v3 clients.
InfluxLoggingHandler class.WriteApi now handles all functions to write to InfluxDB.
ConfigurationApiClientWriteServiceInfluxDBClientwrite_client._sync.RestClient - this class is now responsible for low-level handling of transport requests. End users should not need to use it directly.write_client.client.WriteApi - all internal settings needed for writing are now encapsulated within this Api.InfluxDBClient3 constructor now has additional parameters for configuring the internal WriteApi and RestClient.
auth_scheme - string - the token authentation scheme, typically Token or Bearer.enable_gzip - boolean - whether or not to compress data in writing payloads.gzip_threshold - int - minimum payload size to trigger gzip compression when enable_gzip is True.point_settings - PointSettings - default settings used when writing Points, primarily used to wrap default tags to be added to Point data.debug - boolean - toggle debug level logging.Configuration, ApiClient, WriteService or legacy InfluxDBClient classes, will need to migrate their settings to the InfluxDBClient3 constructor.#222: Refactor MultiprocessingWriter class.
DefaultContext.Process(target) to prevent erratic crashes, handle cross-platform code behavior safely, and coordinate complex resource sharing.fork, spawn or forkserver when creating new Process. The default will be spawn.process_ttl parameter, the default value will be 300 seconds.Remove cookie/session-based signin/signout support from the writing client.
influx3 query CLI support for executing SQL/InfluxQL queries with JSON/JSONL/CSV/pretty output, including module execution via python -m influxdb_client_3.no_sync requires use_v2_api=False; accept_partial applies only to V3 API endpoint writes.Features #198 : Support custom tag order via tag_order write option. See Sort tags by priority for more. #202 : Add escape for field keys when seriali
tag_order write option.PolarsDataframeSerializer.tag_order write option.
See Sort tags by priority for more.PolarsDataframeSerializer.Features #196 : Support passing middleware functions to the Flight client. Bug Fixes #194 : Fix InfluxDBClient3.write_file() and InfluxDBClient3.write
write_dataframe() : New method for writing pandas and polars DataFrames with explicit parameters ( measurement , timestamp_column , tags , timestamp_t
write_dataframe(): New method for writing pandas and polars DataFrames with explicit parameters (measurement, timestamp_column, tags, timestamp_timezone).query_dataframe(): New method for querying data directly to a pandas or polars DataFrame via the frame_type parameter.disable_grpc_compression parameter in InfluxDBClient3 constructorINFLUX_DISABLE_GRPC_COMPRESSION environment variable support in from_env()flush() method to InfluxDBClient3:
TypeError when writing DataFrames. Serializer-specific kwargs (e.g., data_frame_measurement_name) are now filtered before being passed to the HTTP layer.ConstantFlightServerDelayed for timeout by @NguyenHoangSon96 in #176Full Changelog: v0.16.0...v0.17.0
write_dataframe(): New method for writing pandas and polars DataFrames with explicit parameters (measurement, timestamp_column, tags, timestamp_timezone).query_dataframe(): New method for querying data directly to a pandas or polars DataFrame via the frame_type parameter.disable_grpc_compression parameter in InfluxDBClient3 constructorINFLUX_DISABLE_GRPC_COMPRESSION environment variable support in from_env()flush() method to InfluxDBClient3:
TypeError when writing DataFrames. Serializer-specific kwargs (e.g., data_frame_measurement_name) are now filtered before being passed to the HTTP layer.ConstantFlightServerDelayed for timeout by @NguyenHoangSon96 in https://github.com/InfluxCommunity/influxdb3-python/pull/176Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.16.0...v0.17.0
write_dataframe(): New method for writing pandas and polars DataFrames with explicit parameters (measurement, timestamp_column, tags, timestamp_timezone).query_dataframe(): New method for querying data directly to a pandas or polars DataFrame via the frame_type parameter.disable_grpc_compression parameter in InfluxDBClient3 constructorINFLUX_DISABLE_GRPC_COMPRESSION environment variable support in from_env()flush() method to InfluxDBClient3:
TypeError when writing DataFrames. Serializer-specific kwargs (e.g., data_frame_measurement_name) are now filtered before being passed to the HTTP layer.CI #153 Add tests for arm64 CircleCI.
InfluxDB3Client() constructor now directly specifies
write_timeout - timeout in milliseconds to be used when writing data.query_timeout - timeout in milliseconds to be used when querying data.client.write() now propagates the argument _request_timeout as an int in milliseconds on the call stack
even in batching mode.client.query() now propagates the argument timeout as a float in seconds on the call stack.Features #146 : Add function to get InfluxDB version. #149 : Run integration tests against a locally started InfluxDB 3 Core server.
New write option ( WriteOptions.no_sync ) added: True value means faster write but without the confirmation that the data was persisted. Default value
WriteOptions.no_sync) added: True value means faster write but without the confirmation thatFalse.INFLUX_WRITE_NO_SYNC)."nanosecond", "microsecond", "millisecond","second" ( in addition to the existing "ns", "us", "ms", "s").Features #130 : Remove org parameters from the example code because It is not mandatory in Influxdb3 #139 : Supports environment variables with the sa
table = await client . query_async ( query )
query_async() method. From this release the client now has a query_async() method that takes advantage of asyncio's event loop to run query calls in their own executor.For example:
table = await client.query_async(query)verify_ssl and ssl_ca_cert in QueryApi.### Bug Fixes 1. #119: Fix use of proxy argument in client and query_api to use in channel solution for GRPC proxy.
proxy argument in client and query_api to use in channel solution for GRPC proxy.fix: 103 batch write example by @karel-rehor in https://github.com/InfluxCommunity/influxdb3-python/pull/112
PolarsDataframeSerializer in batching modeFull Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.9.0...v0.10.0
feat: expose response headers in InfluxDBError by @karel-rehor in https://github.com/InfluxCommunity/influxdb3-python/pull/108
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.8.0...v0.9.0
InfluxDBError. Example handle_http_error added.fix: handle Edge errors by @alespour in https://github.com/InfluxCommunity/influxdb3-python/pull/100
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.7.0...v0.8.0
fix: Polars optional import by @alespour in https://github.com/InfluxCommunity/influxdb3-python/pull/95
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.6.1...v0.7.0
fix: missing module declaration by @bednar in https://github.com/InfluxCommunity/influxdb3-python/pull/98
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.6.0...v0.6.1
refactor: to timezone specific datetime helpers to avoid use deprecated functions by @bednar in https://github.com/InfluxCommunity/influxdb3-python/pu…
timezone specific datetime helpers to avoid use deprecated functions by @bednar in https://github.com/InfluxCommunity/influxdb3-python/pull/86Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.5.0...v0.6.0
datetime.fromisoformat over dateutil.parse in Python 3.11+user-agent header value to influxdb3-python/{VERSION} and add it to queries as well.timezone specific datetime helpers to avoid use deprecated functionschore: add py.typed stub to root package by @michealroberts in https://github.com/InfluxCommunity/influxdb3-python/pull/84
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.4.0...v0.5.0
from influxdb_client_3 import InfluxDBClient3
with InfluxDBClient3(host="https://us-east-1-1.aws.cloud2.influxdata.com",
token="my-token",
database="my-database") as client:
table = client.query("select * from cpu where host=$host", query_parameters={"host": "server01"})
print(table.to_pandas())
write_options instead of the object name WriteOptionspy.typedchore: improve GitHub integration, add CI config by @bednar in https://github.com/InfluxCommunity/influxdb3-python/pull/78
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.3.6...v0.4.0
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.3.5...v0.3.6
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.3.5...v0.3.6
updated build info by @Jayclifford345 in https://github.com/InfluxCommunity/influxdb3-python/pull/75
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.3.4...v0.3.5
Nothing published for this version
HOTFIX: Removed the print statements and added error handling for missing timestamps
HOTFIX: Removed the print statements and added error handling for missing timestamps
Updated README
Nothing published for this version
The release includes custom headers.
The release includes custom headers.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
fixed error handling by @Jayclifford345 in https://github.com/InfluxCommunity/influxdb3-python/pull/33
Full Changelog: https://github.com/InfluxCommunity/influxdb3-python/compare/v0.1.6...v0.1.7
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →