Python library for the BME680 gas, temperature, humidity and pressure sensor.
Switch branches/tags
Clone or download
Latest commit e97c5f9 Sep 3, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Check for both i2c addresses in examples Sep 3, 2018
library Fixed Travis badge URL Sep 3, 2018
packaging Prep for v1.0.5 Jun 1, 2018
.gitignore Test suites and code QA fixes Sep 2, 2018
.travis.yml Test suites and code QA fixes Sep 2, 2018
LICENSE Create LICENSE Feb 20, 2018
Makefile Added BG tooling Aug 14, 2018 Fixed Travis badge URL Sep 3, 2018 Added BG tooling Aug 14, 2018
terminal.jpg Added terminal image. Oct 19, 2017 Added BG tooling Aug 14, 2018


Build Status Coverage Status PyPi Package Python Versions

The state-of-the-art BME680 breakout lets you measure temperature, pressure, humidity, and indoor air quality.


Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your BME680 up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal on your Raspberry Pi desktop, as illustrated below:

Finding the terminal

In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:

curl | bash

Manual install:

Library install for Python 3:

sudo pip3 install bme680

Library install for Python 2:

sudo pip2 install bme680


If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:

sudo python3 install

(or sudo python install whichever your primary Python environment may be)

In all cases you will have to enable the i2c bus.

Documentation & Support