Skip to content
View kinuthia-mark's full-sized avatar
💻
Locked in
💻
Locked in

Highlights

  • Pro

Block or report kinuthia-mark

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
kinuthia-mark/README.md

Hi, I'm Mark Kinuthia

Full-stack developer in Kenya. I build web apps end to end, from the database schema and API to the UI, the tests and the CI pipeline. I'm especially interested in AI that runs offline on ordinary hardware, so patient and business data never has to leave the machine.

Right now I'm building an offline clinical consultation assistant: local speech recognition with Whisper, a quantized medical LLM and an encrypted local database, all on a desktop with no internet connection.

Python TypeScript PHP Django Next.js Laravel Docker GitHub Actions Terraform


Featured projects

Brand monitoring dashboard: mentions, sentiment, crisis alerts, PDF reports and a data assistant. Next.js 16 + TypeScript frontend, Django REST Framework API.

socialNET dashboard

  • Wrote a sentiment and risk engine from scratch: handles negation, intensifiers, emoji and shouting, finds risk terms such as "recall" or "lawsuit", and agrees with 7 of 8 hand-labelled posts
  • Every KPI, chart and the brand health score is computed from about 10,000 mentions in the database, each labelled by that engine
  • JWTs never reach page scripts: Next.js route handlers keep them in httpOnly cookies, with refresh-token rotation and blacklisting
  • 42 API tests, 17 frontend tests (Vitest), type check, production build and a full Docker Compose run in CI

Digital queue for government service offices. Applicants join from their phone, see how many people are ahead and how long they have left, and get an email when they are called. A TV board in the waiting room shows who is being served. Laravel 12.

eQueue waiting-room display board

  • Wait estimates learned per service from real called_at / completed_at history
  • Race-safe: queue numbers and "call next" run in locked database transactions, so two officers can never call the same person
  • 25 feature tests on PHP 8.2 and 8.3, Pint style check, and a production-style Docker image (Apache, OPcache, cached config) started and checked in CI

CI/CD gate that blocks builds only on vulnerabilities that can actually be exploited, with severity-based fix deadlines. Open Policy Agent (Rego), Python, Terraform, GitHub Actions.

Trivy scan ─► normalize-trivy.py (+ CISA Known Exploited list) ─► OPA policy ─► pass / block + Jira ticket
  • Gates the real container image on every push, not just sample data
  • 14 Rego policy tests and 12 pytest tests; Terraform checked with TFLint and Checkov
  • Found and fixed bugs in my own earlier version: SLA breaches never reached the report, and false positives still blocked builds

Website and content admin for a children's home in Kenya. PHP 8 + MariaDB.

Nyumbani blog page

  • Hashed passwords, prepared statements, safe uploads, CSRF tokens on every admin form, and no state change ever triggered by a plain link
  • A Playwright browser test drives the whole admin against a real database in CI, including forged requests that must be refused
  • Runs with one docker compose up

More

Project What it is Built with
Medical-Pro Desktop app that turns a doctor-patient transcript into a SOAP note. Visit templates (paediatrics, mental health, follow-up), a check that flags notes missing a SOAP section, 41 headless unit tests and a screenshot rendered in CI Godot 4, GDScript, Gemini API
Comfort Executive Suites Live website for a hotel in Ongata Rongai (view site). Validated HTML, WebP photos with JPEG fallback, lazy loading, CI with link checks and an image size limit HTML, CSS
Offline Clinical Consultation Assistant Records a consultation, transcribes it and drafts clinical notes, fully offline (in progress) Python, Whisper, local LLM, SQLCipher

What I work with

Area Tools
Languages Python, TypeScript / JavaScript, PHP, SQL, C#, Java, GDScript
Backend Django REST Framework, Laravel, Node.js
Frontend Next.js, React, Tailwind CSS, Bootstrap, TanStack Query
Data MySQL / MariaDB, SQLite, SQLCipher, Firebase
AI Whisper, local LLMs (GGUF quantization, Ollama), Gemini API, lexicon-based NLP
Testing PHPUnit, pytest, Django test runner, Vitest, Playwright, OPA test
DevOps and security Docker, GitHub Actions, Terraform, Open Policy Agent, Checkov, TFLint, Trivy

How I build

  • Tests and CI from the start. Every project here runs its checks on each push, and the Docker setups are started and exercised in CI, not just built.
  • Security by default. Secrets in environment variables, CSRF on every form, prepared statements, unguessable links, least-privilege database users.
  • READMEs that explain the system, with architecture diagrams, data models and screenshots, not just install steps.

Popular repositories Loading

  1. comfort-website comfort-website Public

    Website for Comfort Executive Suites, a hotel in Ongata Rongai, Kenya.

    HTML 1

  2. Equeue-project Equeue-project Public

    Queue management for government service offices: join from your phone, watch your place live, get emailed when called. Laravel 12.

    Blade 1 1

  3. Nyumbani-website-rebuild Nyumbani-website-rebuild Public

    Website and admin panel for Nyumbani Children's Home, Kenya. PHP and MariaDB with a draft/publish content workflow.

    PHP 1

  4. nursingsystem nursingsystem Public

    CSS 1

  5. Devsec-gate Devsec-gate Public

    CI/CD security gate that blocks builds on exploitable vulnerabilities only, with severity-based SLA windows. OPA/Rego, Terraform, Trivy.

    Python 1

  6. MedicalProV1 MedicalProV1 Public

    Desktop app that turns doctor-patient transcripts into SOAP notes. Godot 4 + Gemini API.

    GDScript 1