[{"_1":2,"_173":-5,"_174":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_149":150},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_140":-5,"_141":11,"_142":17,"_143":11,"_144":-5,"_145":11,"_146":-5,"_147":148},"canonicalUrl","https://hub.docker.com/r/theiamdude/ffiiitc/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","theiamdude","reponame","ffiiitc","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2024-03-10T03:49:39.168431Z","description","","is_private","last_updated","2024-03-10T03:49:40.787826Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",1833,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# FireFly III Transaction Classification\n\nThis little web service performs transaction classification and integrates with [FireFly III](https://github.com/firefly-iii/firefly-iii) (A free and open source personal finance manager) via web hooks.\n\n### What is does?\n\nEvery time you add new transaction to FireFly III, either manually or via import tool, web hook will trigger and provide transaction description to `ffiiitc`. It will then be classified using [Naive Bayesian Classification](https://en.wikipedia.org/wiki/Naive_Bayes_classifier) and transaction will be updated with matching category.\n\n> Naive Bayesian classifier go package used by `ffiiitc` is available [here](https://github.com/navossoc/bayesian). Please read the [license](https://github.com/navossoc/bayesian/blob/master/LICENSE).\n\n### How to run?\n\n#### Pre-requisites\n\n- [Docker desktop](https://www.docker.com/products/docker-desktop/) or any other form of running containers on your computer\n- [FireFly III](https://github.com/firefly-iii/firefly-iii) up and running as per [docs](https://docs.firefly-iii.org/firefly-iii/installation/docker/?mtm_campaign=docu-internal&mtm_kwd=docker)\n- At least **one or two statements** imported into FireFly with transactions manually **categorised**. This is required for classifier to train on your dataset and is very important.\n- Have personal access token (PAT) generated in FireFly III. Go to `Options->Profile->OAuth` click `Create new token`\n\n##### Docker Compose\n\n- `git clone https://github.com/akopulko/ffiiitc.git`\n- `docker buildx build --load --platform=linux/amd64 -t ffiiitc:latest .`\n\n#### Run\n\n##### Docker Compose\n\n- Stop `docker compose -f docker-compose.yml down`\n- Modify your FireFly III docker compose file add the following\n\n```yaml\n fftc:\n image: akopulko/ffiiitc:latest\n hostname: fftc\n networks:\n - firefly_iii\n restart: always\n container_name: ffiiitc\n environment:\n - FF_API_KEY=\n - FF_APP_URL=\n volumes:\n - ffiiitc-data:/app/data\n ports:\n - ':8080'\n depends_on:\n - app\nvolumes:\n ...\n ffiiitc-data:\n```\n\nYou can also append your environment variable names with `_FILE` instead, having their value point to the file where tha actual sensitive value is stored. This works with any environment variable.\n\n```yaml\nsecrets:\n ffiiitc-personal-access-token:\n file: \"/ffiiitc-personal-access-token\"\n\nservices:\n ...\n fftc:\n image: akopulko/ffiiitc:latest\n hostname: fftc\n networks:\n - firefly_iii\n restart: always\n container_name: ffiiitc\n secrets:\n - \"ffiiitc-personal-access-token\"\n environment:\n - FF_API_KEY_FILE=\"/run/secrets/ffiiitc-personal-access-token\"\n - FF_APP_URL=\n volumes:\n - ffiiitc-data:/app/data\n ports:\n - ':8080'\n depends_on:\n - app\n\nvolumes:\n ...\n ffiiitc-data:\n```\n\n- Start `docker compose -f docker-compose.yml up -d`\n\n#### Docker\n\n```\ndocker run\n -d\n --name='ffiiitc'\n -e 'FF_API_KEY'=''\n -e 'FF_APP_URL'=''\n -p ':8080'\n -v '':'/app/data':'rw' 'ffiiitc'\n```\n\n#### Configure Web Hooks in FireFly\n\nIn `FireFly` go to `Automation -> Webhooks` and click `Create new webhook`\n\n- Create webhook for transaction classification\n\n```yaml\ntitle: classify\ntrigger: after transaction creation\nresponse: transaction details\ndelivery: json\nurl: http://fftc:/classify\nactive: checked\n```\n\n### Troubleshooting\n\n#### Logs\nYou can check `ffiiitc` logs to see if there are any errors:
`docker compose logs fftc -f`\n\n#### Forced training of your model\nThere is also option available to force train the model from your transactions if required. \nTo trigger force train run the following command and restart `fftc` container:\n`curl -i http://localhost:/train` where `EXPOSED_PORT` is the port you provided in your docker compose for `fftc`. \nAs always, you can check logs to see if model was successfully regenerated. \n\n#### Firefly timeout\nUpdate the timeout value to 20sec to validate config.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",18286879,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":129,"_130":90,"_131":29,"_132":52,"_53":133,"_134":135,"_136":105,"_137":129,"_138":62,"_139":17},"content_type","creator",920747,"digest","sha256:af281c80d31597ab5c95dd4ed430b465bf7c3a5988a3d5573d91826a8d640b1a","full_size",9352120,"id",618428583,"images",[99,114,120,126],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:8a92bd0cd3862ef02f8481f46920c39c88c09ac6a58b04cf78323ce8b406054a","features","last_pulled","2026-09-27T08:46:33.675226839Z","last_pushed","2024-03-10T03:49:39Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":118,"_59":119,"_113":-5},"arm64","sha256:c08bdd29c0e773900463cc6cd4ed0edd4721de3a54e873c68c068d91403acfdc","2026-08-10T17:22:09.690272248Z",8899180,"inactive",{"_100":121,"_91":122,"_103":44,"_104":123,"_106":124,"_108":121,"_110":44,"_111":-5,"_112":125,"_59":119,"_113":-5},"unknown","sha256:faf8a7847f371dcf69ae0bd70fe2af9f5ac5087a1de0894be25db57ef1e166e3","2026-08-10T17:22:09.68679621Z","2024-03-10T03:49:40Z",13755,{"_100":121,"_91":127,"_103":44,"_104":128,"_106":124,"_108":121,"_110":44,"_111":-5,"_112":125,"_59":119,"_113":-5},"sha256:dc721085ff244de9c46371679ad803e0466bfd88f436e20ece331e4bdf07add6","2026-08-10T17:22:09.685577207Z","2024-03-10T03:49:40.75237Z","last_updater","last_updater_username","media_type","latest","repository",23517171,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":151,"_158":159,"_147":171,"_172":11},{"_36":152,"_38":153,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":154,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":155,"_75":11,"_76":157,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":156},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_160":60,"_161":-5,"_162":-5,"_163":164},"count","next","previous","results",[165],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":166,"_46":129,"_130":90,"_131":29,"_132":52,"_53":133,"_134":135,"_136":105,"_137":129,"_138":62,"_139":17},[167,168,169,170],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":118,"_59":119,"_113":-5},{"_100":121,"_91":122,"_103":44,"_104":123,"_106":124,"_108":121,"_110":44,"_111":-5,"_112":125,"_59":119,"_113":-5},{"_100":121,"_91":127,"_103":44,"_104":128,"_106":124,"_108":121,"_110":44,"_111":-5,"_112":125,"_59":119,"_113":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
8a92bd0cd386	linux/amd64	8.92 MB
c08bdd29c0e7	linux/arm64	8.49 MB

theiamdude/ffiiitc

Tags for theiamdude/ffiiitc