Skip to main content

http://foobot.io/ is awesome home air monitor solution, that helps you monitor and control your indoor air quality. Welltory integrated with foobot.io and we share our Python API wrapper with you.

Install

$ pip install foobot

Usage

from foobot.api import FoobotAPI

api = FoobotAPI(
    api_key=<YOUR_API_KEY>,
    access_token=<YOUR_ACCESS_TOKEN>,
    homehost=<YOUR_HOME_HOST>,
    username=<YOUR_USER_EMAIL,
    client_key=<YOUR_CLIENT_KEY>,
    client_secret=<YOUR_CLIENT_SECRET>,
)
devices = api.get_devices()
data_by_devices = api.get_last_day_data()

API reference

FoobotAPI

  • get_devices() return list of dict described devices connected to this accunt

  • get_last_day_data() return list of data from devices
    • raw (Default: False) - return data as a dict or as a FoobotDataItem instance

  • get_data() return list of data from devices
    • start (Default: 3600*24) - return data as a dict or as a FoobotDataItem instance

    • end (Default: “last”) - return data as a dict or as a FoobotDataItem instance

    • average_by (Default: 3600) - return data as a dict or as a FoobotDataItem instance

FoobotDataItem

  • timstamp - timestamp for measure

  • particulate_matter (ppm) - particulate matter

  • temp (C) - temperature

  • humidity (pc) - humidity

  • co2 (ppm) - CO2

  • voc (ppb) - volatile organic compounds

  • foobot_index - Internal index for Foobot

License

The MIT License (MIT)

Tests

$ python setup.py test

Contributors

Metadata

Release files for foobot 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for foobot 1.0.4
File Size Uploaded
foobot-1.0.4.tar.gz 5.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for foobot 1.0.4
File Interpreter ABI Platform
foobot-1.0.4-py2-none-any.whl Python 2 none any Details

Total release size: 11.2 kB

Release files / foobot-1.0.4.tar.gz

Download URL foobot-1.0.4.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
3d977de62a24b214d68d3f40af1e274ba276b94a158943e081b69c60a55dbb98
BLAKE2b-256 checksum
How to use checksums
52ce380454a4ba23f32db49444e5e822bee8c68f8ac3e5dc1aa8d603d7a28eda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / foobot-1.0.4-py2-none-any.whl

Download URL foobot-1.0.4-py2-none-any.whl
Size 5.5 kB
Tags Python 2
SHA-256 checksum
How to use checksums
640d7788042fc08bc4f6373e19a498adea19d482faf4a932d863fed211bad17d
BLAKE2b-256 checksum
How to use checksums
0e167e483c58ccc41bd6407b2580d78704e11539e6134c7b2a2a5de713282a2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

1.0.4 This release

2 release files

1.0.2

1 release file

1.0.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page