---
title: Order Triage
emoji: 🏆
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 6.18.0
python_version: '3.13'
app_file: app.py
pinned: false
license: mit
tags:
  - backyard-ai
  - track:backyard
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference


# 📦 Order Triage Assistant

**Backyard AI track — Build Small Hackathon**

## The problem

At Zipline's KD-1 distribution centre (Kaduna, Nigeria),many drone delivery orders for medical supplies
and vaccines arrive as informal, abbreviation-heavy text messages via Telegram/social
channels — e.g.:

```
Pcm syrp 4
Pcm drop 3
Pcm tabs 1 pkt
Given set 1
Scalvein 10 mixed 23g and 21g
```

```
Marmara Hc
Vaccines requesiton tomorrow 11/06/2026 Thursday please
BCG 20 doses
Opv40
Penta 30
...
```

Fulfillment staff then manually re-type each line into the inventory/order
fulfillment system — slow, error-prone, and easy to misread abbreviations
(is "Scalvein 10 mixed 23g and 21g" two items or one?).

## What this app does

1. **Paste the raw order text** as received.
2. A small LLM (Cohere Command, ≤32B class) extracts structured data:
   sender, facility, requested date, urgency, and a list of line items
   (item name, quantity, unit), expanding common abbreviations.
3. Each item is **fuzzy-matched against your product catalogue** (with SKU codes),
   so "PCM syrp" → "Paracetamol Syrup 120mg/5ml" with its real SKU.
4. Low-confidence matches are **flagged for human review** rather than guessed silently.
5. Output is shown as an **editable table** and exported as **JSON** (ready to feed
   to an inventory API) and **CSV**.

## Catalogue

This Space ships with a small **sample catalogue** (`sample_catalogue.csv`) covering
the product categories seen in real KD-1 orders (analgesics, vaccines, syringes,
cannulas, diluents, etc.) — built for demo purposes without exposing any internal
Zipline data.

To use with a real catalogue, upload your own CSV with columns:
`sku_code, product_name, category, unit`

## Setup

1. Get a [Cohere API key](https://dashboard.cohere.com/api-keys) (free tier credits work fine).
2. Set it as an environment variable `COHERE_API_KEY`, or paste it into the
   "Settings" panel in the app (not stored).
3. `pip install -r requirements.txt`
4. `python app/app.py`

## Demo
[Here](https://youtu.be/PP_JcqlZEmg) is the link to the demo

## Social Media Post 
[Here](https://x.com/LukmanAJJK/status/2066260421611315625?s=20) is the X post on my submission

## Roadmap / next stretch

- Voice input for low-literacy users.
- Direct push to inventory system API (instead of JSON export).