basic readme

README.md

@@ -0,0 +1,26 @@
+# Budget Exporter
+
+Export Firefly-iii budget data for prometheus consumption.
+
+## Usage
+
+Install `Flask` and `requests` in your python environment:
+
+    pip install -r requirements.txt
+
+Create a personal access token in your firefly installation:
+
+Go to
+[https://your-firefly-installation/profile](https://your-firefly-installation/profile)
+, create a token and copy the (very long) string.
+
+Put your personal access token and your API host in your environment:
+
+    export FIREFLY_PERSONAL_ACCESS_TOKEN="abcd.....1234"
+    export FIREFLY_API_HOST="https://your-firefly-installation"
+
+Run the exporter:
+
+    FLASK_APP=exporter.py python -m flask run -h 127.0.0.1 -p 5000
+
+Now scrape `/metrics` on port localhost:5000.