InfluxDB-Python is a client for interacting with InfluxDB.

InfluxDB is an open-source distributed time series database, find more about InfluxDB at http://influxdb.com/

InfluxDB v0.9.0 brings many changes to the influxDB api. v0.9.0 users may use the 0.9.0_support branch. Keep in mind that this is a development branch and may break. When v0.9.0 is released, we will merge the 0.9.0_support branch to master and push it to pypi.

You may install it from pip with the following command:

$ pip install https://github.com/influxdb/influxdb-python/archive/0.9.0_support.zip 

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.2, 3.3, 3.4, PyPy and PyPy3.

Main dependency is:

• Requests: HTTP library for human beings (http://docs.python-requests.org/)

Additional dependencies are:

• pandas: for writing from and reading to DataFrames (http://pandas.pydata.org/)
• Sphinx: Tool to create and manage the documentation (http://sphinx-doc.org/)
• Nose: to auto-discover tests (http://nose.readthedocs.org/en/latest/)
• Mock: to mock tests (https://pypi.python.org/pypi/mock)

InfluxDB-Python documentation is available at http://influxdb-python.readthedocs.org

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 = [{ "points": [ ["1", 1, 1.0], ["2", 2, 2.0] ], "name": "foo", "columns": ["column_one", "column_two", "column_three"] }] >>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example') >>> client.create_database('example') >>> client.write_points(json_body) >>> result = client.query('select column_one from foo;') >>> 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: http://influxdb.com/community/.

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

The source code is currently available on Github: https://github.com/influxdb/influxdb-python