Create Readme.md

Readme.md

@@ -0,0 +1,33 @@
+# Caps-Train
+
+A small executable to train an image classifier for [Caps-Server](https://christophhagen.de/git/ch/Caps-Server).
+
+## Classifier training
+
+The main server is running on Linux, which doesn't provide the CreateML framework required for classifier training.
+
+Running this executable will:
+- Fetch the current image catalog by checking missing and changed images
+- Train a classifier on the image set
+- Increment the classifier version and upload the new model
+- Update the list of caps which can be recognized using the classifier
+- Create missing thumbnails for each cap for the cap grid
+
+A configuration file is required to run the training, with a valid access token for the server:
+
+```json
+{
+    "folder": "../Public",
+    "iterations": 20,
+    "server": "https://mydomain.com/caps",
+    "authentication": "mysecretkey",
+}
+```
+
+The configuration file `config.json` must be located in the `Config` folder.
+
+To start the training (on macOS), run from inside the package folder:
+
+```bash
+swift run -c release
+```