All plugins

microbiz-desk

Customers, sales, debts and weekly reports for small businesses. Works offline, no API key needed.

Danzilla0Toolsv1.0.0Updated 3 hours ago

MicroBiz Desk

A small-business desk for Hermes Agent. Track customers, sales and debts, and get a plain-English weekly report. Works fully offline: data stays in a local SQLite file, no API key needed.

What it adds

AI tools (the agent uses them when you talk normally, e.g. "Mama Ngozi bought 2 bags of rice for 45000 and paid 20000"):

  • microbiz_add_sale, microbiz_record_payment, microbiz_who_owes_me, microbiz_customer_statement, microbiz_report

Typed commands (no AI model needed): /microbiz ... in a chat, or hermes microbiz ... in a terminal:

hermes microbiz sale "Mama Ngozi" "2 bags rice" 45000 --paid 20000
hermes microbiz pay "Mama Ngozi" 10000
hermes microbiz owing
hermes microbiz report --days 7
hermes microbiz statement "Mama Ngozi"

Install

Copy this folder to <HERMES_HOME>/plugins/microbiz-desk, then run hermes plugins enable microbiz-desk.

Why it is more than a prompt or skill

It stores real data between sessions, does exact money maths (whole kobo, no rounding drift), refuses overpayments and ambiguous customer names, and works with or without an AI model.

Tests

python tests/test_microbiz.py

Disclosure

  • No network calls. The plugin never contacts any server or third-party service.
  • No API keys or credentials. It reads and stores none.
  • No shell commands and no background processes.
  • Data location: one local SQLite file, microbiz/microbiz.db, inside the Hermes data folder (HERMES_HOME). The plugin reads and writes nothing else outside its own code.
  • No telemetry.

README from the reviewed commit c737d9e; it updates when the author re-pins.