Independent developer · Panauti, Nepal

Kushal Sapkota: I build systemsthat think.And automate.

~/kushal $

I engineer backends, AI agents, and automation systems that help real businesses work smarter.

Hi, I’m Kushal!
Portrait of Kushal Sapkota at his desk

Four disciplines, one connected workflow. Hover, focus or tap a module to see how it fits.

Optional · interactive

Don’t just scroll. Play.

Walk a little robot around a 3D island built from my work: the Karkiz AI agent, KusBill, live client sites and more. Visit all six stations.

Keyboard, mouse or touch · about 2 min

01About

The engineer behind the systems.

Kushal Sapkota — Django Developer and AI-Native Engineer, studying at Virinchi College

Who is Kushal Sapkota?

Kushal Sapkota is a backend developer and AI-native automation engineer from Panauti, Nepal. I turn messy manual processes into reliable systems. By day a BICT student at Virinchi College, by night a freelancer building with Python, Django, LLMs and n8n, from client sites to AI products for health, farming and education.

GitHub · live

54public repos
4followers

Last push NewAge I.T. Solution Center · 2 days ago

@kushal867

How I build agents

Tools are SQL. Guards are code. The LLM sits in the middle, not on top.

Watch one run

Based in

Panauti,
Nepal

Education BICT student at Virinchi College

Founder

Building Affaiai, AI WhatsApp automation

aafaiai.com

02System map

One engineer. Multiple systems. One connected workflow.

Four disciplines and the real projects that connect them. Select one to follow its path.

02 / 04

AI systems

The model in the middle, rules around it.

LLM integrations, agents with tools, structured output and guardrails. The model proposes; code decides.

Technologies

  • LLM integrations (OpenRouter, Ollama)
  • Agents with tool calling
  • Structured output
  • Guardrails and validation
  • Vision models
  • LangChain · Chainlit

Example path · Karki’z AI agent

  1. Customer message
  2. Input processing
  3. AI agent + database tools
  4. Business rules in code
  5. Validated reply

Where it shows up

  • Karki’z AI ordering agentNepali WhatsApp ordering agent on n8n · In production
    Live
  • AffaiaiAI WhatsApp automation platform I founded · In development
  • AAFAI Video MakerFree AI cartoon video maker that speaks Nepali · Live · free to try
  • Nexus AI, an n8n chat studioChat front end for n8n webhooks · Live demo
  • Health Service AISymptom suggestions from a local LLM · Prototype
  • College FinderCollege search with AI comparison · Prototype
  • Farmers AIFarming Q&A with plant-photo diagnosis · Prototype
  • Autism Screening AssistantScreening-support prototype (synthetic data) · Prototype

03Automation

Watch an AI agent handle an order.

The business problem: a cake shop receives orders as mixed-language WhatsApp messages, voice notes and photos. Every order had to be captured accurately, and no AI model could be allowed to decide a payment.

karkiz-agent /WhatsApp orderingvisualisation
Not a live connection
  1. 1Customer message
  2. 2Input parsing
  3. 3Conversation state
  4. 4AI agent + tools
  5. 5Guardrails + processing
  6. 6Validated reply
1 item1 item1 item1 item1 item1 item1 item1 item1 itemtruefalsereplyorderhelpWhatsApp Triggerwebhook · POSTParse & DedupeCodeBot Paused?IfHuman Handoffnot triggeredAI AgentTools Agentstructured output ✓GuardrailsCode nodeRouteIf nodesSend ReplyWhatsApp · HTTPSave OrderPostgresAlert Ownernot triggeredChat ModelOpenRouterMemoryPostgresSQL Tools ×5Postgres

Select any node to see what it does in the real workflow.

Incoming · WhatsApp

Do you have a chocolate cake for tomorrow morning?

Reply · sent by the agent

Yes! Chocolate Delight Cake, 1 pound from Rs 1,500. Which size would you like?

Replay finished: reply sent, order saved. Two branches were not needed.

Sample conversation with names removed. A simplified visualisation of the production workflow, not a live connection.

A simplified visualisation of the production workflow, which runs 98 nodes across 5 n8n workflows. Read the full case study

04Case studies

Two systems, built and shipped.

Each one tells the same story: the problem, the architecture, the decisions and the result, with real screens.

Production AI agent · n8n

Shipping an AI agent to a real shop.

A Nepali-language ordering agent for Karki’z cakes on WhatsApp and the website. Customers write Nepali, Roman Nepali and English, often in one message, and send voice notes, photos and payment screenshots.

In production for Karki’z Cakes
  • n8n
  • PostgreSQL
  • OpenRouter
  • 360dialog API
  • Docker
98workflow nodes
2channels
3languages
5n8n workflows
See the shop
01

The problem

Five constraints that shaped it

  1. 01Customers write Nepali, Roman Nepali and English, often in one message.
  2. 02Orders arrive as voice notes, photos and payment screenshots.
  3. 03A non-technical owner must change behaviour without calling me.
  4. 04Money is involved: the model must never decide a payment.
  5. 05It must fail loudly. No silent drops.
02

The architecture

One message, seven stages

Channels
  • WhatsApp · 360dialog
  • Website chat
Ingest
  • Webhook
  • Dedupe
  • Voice → speech-to-text
  • Image fetch
Gate
  • Chat paused for team?
  • Owner settings
  • Debounce
Agent
  • LLM
  • Memory
  • 5 SQL tools
  • Structured output
Guards · code
  • Feature flags
  • Items valid?
  • Date valid?
  • Fee calculation
Actions
  • Reply + photos
  • Payment QR
  • Save order
  • Telegram alert
State
  • PostgreSQL
  • Admin panel
  • Inbox

Tools are SQL. Guards are code. The LLM sits in the middle, not on top.

n8n canvas showing the nodes that send replies, ask for help and record payment proofs
The real n8n canvas: what the bot does with the answer.
03

The engineering decisions

Seven decisions that kept it reliable

  1. 01
    The model proposes. Code decides.

    The owner’s feature switches are re-checked in code after the model answers, so “off” really means off. Totals and fees are computed in SQL, never by the model.

  2. 02
    Structured output, not free text.

    One reply for the customer and machine-readable fields for the workflow. A parser fixes the shape before anything downstream runs, and the agent never writes to the database.

  3. 03
    Tools, not memorised facts.

    Five SQL tools (cakes, occasions, delivery zones, time slots, payment methods) mean a price changed in the admin is used by the bot on the next message.

  4. 04
    Reading payment proofs, carefully.

    A vision model reads the paid amount and a backup model tries if the first cannot. The result only flags the order for the owner to confirm; the AI cannot mark it paid.

  5. 05
    Behaviour as data.

    The owner flips switches, edits FAQs and adds holiday notices in an admin panel, and a Postgres function composes them into the prompt.

  6. 06
    Humans stay in the loop.

    One inbox for WhatsApp and web chats. A staff reply pauses the bot for that customer, and the owner is alerted on Telegram when it needs help.

  7. 07
    Test on a copy, never the live shop.

    Tests run on a copy of the workflow with every send node disabled and fake phone numbers, and each deploy is diffed node by node.

04

Result and status

In production for Karki’z Cakes

Admin inbox with a customer conversation open and the bot-replying toggle
The owner’s inbox: WhatsApp and web chats in one place. Names and messages are sample data.
Bot settings panel with toggles for WhatsApp bot, website chat bot and taking orders
Bot settings: the owner switches abilities on and off without calling me.
What broke, and what changed
  • Website chat went silent for about an hour.A regenerated workflow was left inactive.Now: check every workflow’s active flag after each deploy.
  • A test left the bot stuck on “always English”.A customer writing Roman Nepali got an English reply.Now: tests restore production defaults.
  • Meta rejected Nepali-script documents, twice.It happened during WhatsApp business verification.Lesson: compliance is part of the system design.
Original slides and recorded demos 16 slides
Karkiz AI agent architecture slide 2 of 162 / 16

Recorded demonstration, not a live connection to the shop.

Read how it was built: How I built a WhatsApp ordering agent in n8n

05Client work

Real businesses. Live websites.

Five live sites I built for clients, shown as they look today.

E-commerceLive client site

Karki’z Cakes

Online shop for cakes, flowers and gifts with pickup or delivery scheduling, plus the Nepali-language AI ordering agent on WhatsApp and website chat, and an admin panel the owner runs herself.

  • Storefront and checkout that saves orders
  • AI agent on WhatsApp and web chat (see the case study)
  • Admin panel: orders, inbox, bot settings
Education consultancyLive client site

Global Times Education

Study-abroad consultancy site with free counselling, university placement, visa and scholarship guidance.

  • Lead-focused landing page
  • Service and destination pages
  • Counsellor contact flow
  • React 19
  • Vite
  • TypeScript
  • Tailwind
  • Framer Motion
Beauty & bridal · BhaktapurLive client site

Bridal Beauty Studio

Portfolio and booking presence for a bridal and professional makeup artist in Bhaktapur.

  • Visual-first portfolio
  • Mobile-first for social traffic
  • Booking call to action
  • React 19
  • Vite
  • TypeScript
  • Tailwind
Fashion accessoriesLive client site

SABSTATION

Premium storefront for shoes, bags and glasses: “Move different. Carry confidence. See clear.”

  • Brand-led storefront
  • Product showcase
  • Admin tools for publishing products
  • Next.js 16
  • React 19
  • TypeScript
  • Tailwind
  • Framer Motion
IT repair lab · KathmanduLive client site

NewAge I.T. Solution Center

Computer and electronics repair lab trading since 2069 B.S.: “Technology repaired properly.” Chip-level repairs, custom PC builds and IT solutions across Kathmandu.

  • Repair booking and tracking
  • Nepali / English language toggle
  • Services, custom PC and product catalogue
  • JavaScript
  • PostgreSQL

06Founder

Affaiai: the company I’m building.

An AI WhatsApp automation platform for businesses, founded and owned by me. It is early stage, and this is what it does today.

Affaiai answers a business’s customer messages from its own FAQ and products, and hands anything it isn’t sure about to a person. It never invents a price, policy or promise.

  • Replies grounded only in the business’s own FAQ entries and product list
  • Unsure or low-confidence questions are handed over to a person
  • Multi-tenant: every business’s data is isolated, and provider credentials are encrypted
  • A guided editor for building and republishing automations, restricted to safe steps
  • An MCP server, so AI assistants can manage a workspace

07Process

From idea to deployed system.

My working approach, shown through two real projects.

  1. 01

    Understand the problem

    Before any code: how does the work actually happen today, and what goes wrong?

    In practice · KusBill

    Started from the real paper billpad: the same fields and habits, so people adopt it.

  2. 02

    Design the architecture

    Decide where each responsibility lives: what the AI may suggest and what the code must decide.

    In practice · Karki’z AI agent

    Tools are SQL. Guards are code. The LLM sits in the middle, not on top.

  3. 03

    Build the system

    Get the data model right first, then the screens and the automation around it.

    In practice · KusBill

    Balances are calculated from the full history and never stored, so they cannot drift.

  4. 04

    Test the behavior

    Test the rules that matter, not only that pages load.

    In practice · Both projects

    KusBill has 148 automated tests against a real database; the AI agent is tested on a copy with every send node disabled.

  5. 05

    Deploy and improve

    Ship to real users early; what they ask next becomes the next feature.

    In practice · KusBill

    The first question from real users, “who owes me?”, became the Parties screen.

This is how I work, drawn from two real projects. It isn’t a guarantee, and it isn’t a client testimonial.

08Projects

Everything I’ve built, honestly labelled.

Production software, live demos and prototypes are marked as exactly what they are.

  • The shop owner’s inbox showing a WhatsApp conversation handled by the agent
    01

    Karki’z AI ordering agent

    In production

    A Nepali-language agent on WhatsApp and website chat that takes cake orders, reads voice notes and payment screenshots, and hands over to staff when it should.

    ProblemOrders arrived as mixed-language messages, voice notes and photos, and the shop needed them captured without a model ever deciding a payment.

    • n8n
    • PostgreSQL
    • OpenRouter
    • 360dialog API
    • Docker
    Live site
  • KusBill ledger with opening balance, totals and a running balance column
    02

    KusBill

    In production

    A billing and ledger app for small Nepali shops: type bills like the paper pad, with balances calculated from history, Bikram Sambat and Gregorian dates, customer and supplier ledgers, and PDF, Excel and CSV reports.

    ProblemA paper billpad is fast until one slip makes every later balance wrong, and nobody can quickly say who still owes what.

    • Next.js 15
    • TypeScript
    • PostgreSQL
    • Prisma
    • Zod
    • Tailwind
    • Vitest
    Code
  • 03

    Affaiai

    In development

    An AI-powered WhatsApp automation platform for businesses, founded and owned by me. It answers customer questions from the business’s own FAQ, hands over to a person when it is not confident, and lets owners build their own flow in a guided editor.

    ProblemSmall businesses answer the same WhatsApp questions all day, and a bot that makes up prices or promises is worse than none.

    Early stage and still growing. See aafaiai.com for what is available today.

    • Django
    • Django REST Framework
    • Celery
    • Redis
    • PostgreSQL
    • React
    • TypeScript
    • Docker
  • The AAFAI Video Maker home page: “Type a script. Get a talking cartoon video.” with a cartoon character and a Make a video button
    04

    AAFAI Video Maker

    Live · free to try

    A free tool where you type a short script, pick a character, and get a talking cartoon video with voice and music for TikTok, Reels or YouTube. A longer mode builds a cartoon of up to 60 seconds with different backgrounds, moods and sound effects.

    ProblemA short talking video in Nepali needs a voice, animation and editing, which is a lot of work for one person.

    I designed the product and built it with AI coding assistance (Claude). Credits for the open-source voices and tools are on the site.

    • Python
    • FastAPI
    • Piper TTS (Nepali voices)
    • FFmpeg
    • Pillow
    • nginx
  • Nexus AI chat studio showing suggested prompts and a welcome message
    05

    Nexus AI, an n8n chat studio

    Live demo

    A chat interface for n8n webhook workflows: paste a webhook URL, talk to the workflow, attach files, switch themes and export conversations. A built-in mock mode lets anyone try it without n8n.

    ProblemGives an n8n webhook workflow a proper chat front end instead of a REST client.

    • React 19
    • Vite
    • n8n webhooks
    • Browser storage
  • 06

    Health Service AI

    Prototype

    A Django app where users describe symptoms, get a plain-language suggestion from a locally run LLM (Ollama) and review their past queries. A learning prototype, not medical advice.

    ProblemExplores giving plain-language health guidance with a model that runs on your own machine.

    • Django
    • Python
    • Ollama (Llama 3)
    • SQLite
  • 07

    College Finder

    Prototype

    A Django REST platform for searching colleges by location, course, budget and facilities, with an Ollama LLM (Llama 3.2) that compares options. Has student, parent and admin roles, favourites and analytics.

    ProblemComparing colleges means weighing many factors at once; this narrows the list and explains the trade-offs.

    • Django
    • Django REST Framework
    • Python
    • Ollama (Llama 3.2)
    • SQLite
  • 08

    Farmers AI

    Prototype

    A chat assistant for farmers: ask about fertilisers, crops and plant diseases, or upload a plant photo for a diagnosis. Built on Chainlit with local models through Ollama and LangChain.

    ProblemPuts farming answers in a chat anyone can use, including from a photo of a sick plant.

    • Python
    • Chainlit
    • LangChain
    • Ollama
  • 09

    Autism Screening Assistant

    Prototype

    A screening-support prototype: an ensemble machine-learning model trained on a synthetic behavioural dataset, plus an LLM that reads free-text behaviour descriptions in a Chainlit chat. A screening aid, not a diagnostic tool.

    ProblemExplores how an LLM and a trained model can work together to flag behaviours worth discussing with a clinician.

    Trained on synthetic data. Not a diagnostic instrument.

    • Python
    • scikit-learn
    • Chainlit
    • LLM
  • 10

    EduPortal

    Source only

    A Django exam-preparation portal with notes, video lectures, mock tests and subscriptions, plus a documented REST API.

    ProblemBrings exam material, practice tests and paid access into one portal.

    The old hosted demo is offline; source on GitHub.

    • Django
    • Django REST Framework
    • Python
    • JavaScript

Client websites are in the Client work section above. All repositories on GitHub

Interactive

Still curious? Ask my terminal.

A small shell wired to the same data as this page. Explore my systems, stack and case studies, or just say hello.

kushal.dev · a shell wired to my real projects. Type a command, or tap one below.
Try: help · systems · case karkiz · stack · play

Got an idea? Let’s build it!

Got an idea or a workflow to automate?

Let’s build
something.

kushalsapkota577@gmail.com

GitHub · LinkedIn