influxdb3-python

What it is and what it does

influxdb3-python is a Python client library for InfluxDB 3.0 that handles both writing time-series data and querying it using SQL or InfluxQL. It abstracts the Flight client protocol and provides a high-level API for common operations: you can write individual points, raw line protocol, entire DataFrames (pandas or polars), or bulk data from CSV/JSON/Parquet files. The library also includes a CLI tool for query workflows.

The package depends on pyarrow, reactivex, certifi, python_dateutil, and urllib3. It is actively maintained, supports modern Python versions (3.9–3.14), and carries no known vulnerabilities. Pandas is optional but recommended for advanced features like DataFrame conversion and file writing. Configuration can be driven by environment variables or constructor arguments, with sensible defaults for local development.

Use it for:

• Write sensor or application metrics to InfluxDB from Python applications in real time.
• Bulk-load historical time-series data from CSV or Parquet files into InfluxDB.
• Query InfluxDB using SQL or InfluxQL and convert results to pandas DataFrames for analysis.
• Build data pipelines that read from external sources and write to InfluxDB with batching and retry logic.
• Use the CLI tool to run ad-hoc queries against InfluxDB from shell scripts or automation workflows.

Worth the install?

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

Writes and queries InfluxDB 3.0 using SQL or InfluxQL, with support for Point objects, line protocol, DataFrames, and file imports.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is MIT-licensed. It is well-suited for any Python application that needs to write to or query InfluxDB 3.0. The main consideration is that pandas is optional; install it separately if you need DataFrame conversion or file import features.

Install

influxdb3-python on PyPI

pip install influxdb3-python

uv add influxdb3-python

poetry add influxdb3-python

Installing influxdb3-python

Before you install

Low install friction with five runtime dependencies including pyarrow, reactivex, certifi, python_dateutil, and urllib3. Actively maintained with recent commits; last release 64 days ago. Supports Python 3.9 through 3.14.

License in practice

MIT-licensed under permissive terms, allowing commercial and private use with minimal restrictions.

Quickstart

pip install influxdb3-python

from influxdb_client_3 import InfluxDBClient3, Point

client = InfluxDBClient3(token="your-token", host="your-host", database="your-database")
point = Point("measurement").tag("location", "london").field("temperature", 42)
client.write(point)

Requires Python 3.9 or above; pandas is optional but needed for to_pandas() and write_file() methods.

Verify before relying

• Performance characteristics and throughput limits for write and query operations
• Exact behavior and error handling for partial writes with the V3 API endpoint
• Whether the CLI tool is production-ready or experimental

Package facts

Evidence: influxdb3_python-0.20.0-py3-none-any.whl

Tags

More Database packages