---
id: influxdb3-python
version: "0.20.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# influxdb3-python — Community Python client for InfluxDB 3.0

License: permissive · Maintenance: active · Downloads: 3.8M/mo

## 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 above — 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

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

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

influxdb 3.0 python client, time series database write query, influxql sql client, write time series data python, dataframe to influxdb, line protocol writer, flight client query, time-series-database, influxdb, cli-included

[View on SkillFed](https://skillfed.io/packages/influxdb3-python) · [View on PyPI](https://pypi.org/project/influxdb3-python/)