Skip to content
Python client for InfluxDB
Branch: master
Clone or download
shantanoo-desai and xginn8 Add Example for sending information to DB via UDP (#648)
Due to lack of documentation for UDP, this example
provides basic usage of sending information points
via UDP. The code structure followed is similar, if
not same as other examples in the `examples` directory.

Signed-off-by: Shantanoo <>
Latest commit d5d1249 Apr 10, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Add Example for sending information to DB via UDP (#648) Apr 10, 2019
examples Add Example for sending information to DB via UDP (#648) Apr 10, 2019
.gitignore Added 'env' to .gitignore Apr 27, 2015
.travis.yml [WIP] add py37 and recent influxdb (#692) Mar 15, 2019 add consistency parameter to write_points (#664) Apr 8, 2019
CODEOWNERS Add CODEOWNERS file for automatic reviewers on GitHub Mar 20, 2019
LICENSE Initial commit Nov 5, 2013 newline Feb 29, 2016
README.rst Python and influxdb supported versions (#693) Mar 16, 2019
dev-requirements.txt Test on py35 and py36 (#458) Jun 5, 2017 Add wheel/twine support Mar 29, 2015
requirements.txt updating deps for py27, including pandas Jun 2, 2017
setup.cfg removed unneeded python directory tag Feb 29, 2016 Fix a warning under Python 3.7 (#697) Apr 7, 2019
test-requirements.txt fixing broken pypy test Oct 28, 2017 Add a test script Jun 9, 2014
tox.ini [WIP] add py37 and recent influxdb (#692) Mar 15, 2019


InfluxDB-Python Documentation Status Coverage PyPI Status

InfluxDB-Python is a client for interacting with InfluxDB.

Development of this library is maintained by:

Github ID URL
@aviau (
@xginn8 (
@sebito91 (

InfluxDB is an open-source distributed time series database, find more about InfluxDB at

InfluxDB pre v1.1.0 users

This module is tested with InfluxDB versions: v1.2.4, v1.3.9, v1.4.3, v1.5.4, v1.6.4, and 1.7.4.

Those users still on InfluxDB v0.8.x users may still use the legacy client by importing from influxdb.influxdb08 import InfluxDBClient.


Install, upgrade and uninstall influxdb-python with these commands:

$ pip install influxdb
$ pip install --upgrade influxdb
$ pip uninstall influxdb

On Debian/Ubuntu, you can install it with this command:

$ sudo apt-get install python-influxdb


The influxdb-python distribution is supported and tested on Python 2.7, 3.5, 3.6, 3.7, PyPy and PyPy3.

Note: Python <3.5 are currently untested. See .travis.yml.

Main dependency is:

Additional dependencies are:


Documentation is available at

You will need Sphinx installed to generate the documentation.

The documentation can be generated by running:

$ tox -e docs

Generated documentation can be found in the docs/build/html/ directory.


Here's a basic example (for more see the examples directory):

$ python

>>> from influxdb import InfluxDBClient

>>> json_body = [
        "measurement": "cpu_load_short",
        "tags": {
            "host": "server01",
            "region": "us-west"
        "time": "2009-11-10T23:00:00Z",
        "fields": {
            "value": 0.64

>>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')

>>> client.create_database('example')

>>> client.write_points(json_body)

>>> result = client.query('select value from cpu_load_short;')

>>> print("Result: {0}".format(result))


Make sure you have tox by running the following:

$ pip install tox

To test influxdb-python with multiple version of Python, you can use Tox:

$ tox


For issues with, questions about, or feedback for InfluxDB, please look into our community page:

We are also lurking on the following:

  • #influxdb on
  • #influxdb on


All development is done on Github. Use Issues to report problems or submit contributions.

Please note that we WILL get to your questions/issues/concerns as quickly as possible. We maintain many software repositories and sometimes things may get pushed to the backburner. Please don't take offense, we will do our best to reply as soon as possible!

Source code

The source code is currently available on Github:


The TODO/Roadmap can be found in Github bug tracker:

You can’t perform that action at this time.