About

About KinetiRx

KinetiRx (Pharma Care Pro) is a self-hosted pharmacy and small-clinic management system — built for independent pharmacies that want a real system of record instead of a spreadsheet, and would rather run it themselves than hand sales and patient data to a SaaS vendor.

Why we built it

Independent pharmacies sit at an awkward spot: too much daily complexity for a notebook or a spreadsheet — batch and expiry tracking, GST invoicing, running credit accounts, patient histories — but a hosted SaaS subscription means recurring cost and someone else’s server holding your customers’ medical purchase history.

KinetiRx is the alternative: the full workflow of a pharmacy counter, running on Go and PostgreSQL, deployed with Docker Compose on hardware you control. There is no monthly per-shop fee — the only ongoing cost is whatever it costs you to run the server.

What it does

The system covers point-of-sale billing with GST invoicing, medicine and lab-test inventory with batch and expiry tracking, a due-khata credit ledger for regular customers, patient records with OPD visit scheduling, daily cash-drawer reconciliation, expense tracking, and role-based employee accounts with per-tab permissions enforced on the server, not just the browser.

Inward OCR — the AI-powered purchase-bill scanner — is the one part of the system that calls an external service. It uses Google Gemini with an API key you provide, and extracts line items from a photographed or scanned purchase bill into inventory for review. Without a key configured, it falls back to a manual entry form; everything else in KinetiRx is unaffected either way.

Architecture

KinetiRx runs as a three-container Docker Compose stack: PostgreSQL, a Go + Gin backend with JWT authentication and bcrypt password hashing, and a React 19 + Vite frontend served by nginx. The frontend proxies API requests to the backend over the internal Compose network, so typically only one port is exposed to your LAN.

Built by NodeDR Infotech

KinetiRx is built and maintained by NODEDR INFOTECH PRIVATE LIMITED — a software company building self-hostable tools for small businesses. Our official site is www.nodedr.com.

The source is publicly visible on GitHub, but the project does not currently carry an open-source license — all rights are reserved by default. If you want to reuse, redistribute, or build on the code, contact us first.

Frequently asked questions

What is due-khata, exactly?

Udhaar or “khata” is the informal running-credit tab many Indian shops and pharmacies keep for trusted regular customers — they take medicine now and settle up later, sometimes in parts. Due-Khata is that same ledger digitized: every due amount, every partial payment, and the full history against a customer, instead of a paper notebook only the counter staff can read.

Is KinetiRx free or open source?

KinetiRx is self-hosted — you run it on your own server and there's no recurring subscription fee. It is not currently released under an open-source license; the source is visible on GitHub, but redistribution or reuse should go through the maintainer. Self-hosted means you own the deployment and the data, not that the code is free to fork.

Does the AI invoice scanning require an internet connection?

The core system — POS, inventory, patients, due-khata, everything — runs entirely on your own Postgres database with no cloud dependency. Inward OCR (the AI purchase-bill scanner) is the one optional exception: it uses Google Gemini and needs an API key you supply. Without a key configured, that one feature falls back to a manual entry form — the rest of the app is unaffected.

What hardware do I need to self-host it?

Anything that runs Docker: a spare PC, a home NAS, or a small VPS. The stack is three containers — PostgreSQL, the Go backend, and an nginx-served React frontend — started with a single docker compose command.

How do I install it?

Clone the repository, copy deploy/.env.example to deploy/.env, fill in a Postgres password, a JWT secret, and an admin password, then run docker compose up. The app opens on the port you configured, and the first login uses the admin credentials you just set.

Can I install it on CasaOS?

A CasaOS App Store manifest (x-casaos v2) is included in the repository and ready to submit. It isn't published to the CasaOS App Store yet — once it is, installing will be a single click from the CasaOS UI. Until then, Docker Compose works on any CasaOS box today.

Does it handle GST billing correctly?

Yes — POS checkout produces a proper GST invoice, and Invoice Settings lets you store your GST and drug-license numbers, invoice numbering scheme, and letterhead so every bill is correctly formatted from the first sale.

Who is KinetiRx for?

Independent pharmacies and small clinics that want a real system of record — billing, stock, patients, dues — instead of a spreadsheet, but don't want their sales and patient data sitting on a SaaS vendor's servers under a monthly subscription.