dunderrrrrr/pi-hole-fastapi

An FastAPI for Pi-hole

PiHole FastAPI

FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints.

Pi-hole is a Linux network-level advertisement and Internet tracker blocking application which acts as a DNS sinkhole (and optionally a DHCP server), intended for use on a private network. It is designed for use on embedded devices with network capability, such as the Raspberry Pi, but it can be used on other machines running Linux and cloud implementations.

PiHole FastAPI

PiHole FastAPI is using PiHole's api.php to create it's own, easy to use API, with backend and docs. SwaggerUI and ReDoc is included in FastAPI.

Installing

Clone repo

$ git clone https://github.com/dunderrrrrr/Pi-hole-FastAPI.git

Copy and edit settings.py.

$ cp settings.sample.py settings.py
$ nano settings.py

Create virtualenv and install requirements.

$ mkvirtualenv --python=/usr/bin/python3 pihole-api
$ pip install -r requirements.txt

Run FastAPI.

$ python run.py

FastAPI: http://127.0.0.1:8000.
SwaggerUI: http://127.0.0.1:8000/docs.
Redoc: http://127.0.0.1:8000/redoc.

Your API token for Pi-hole can be found in the Pi-hole settings tab (https://your.pihole.com/settings.php?tab=api).