VetBrief: Turning Worried Pet-Owner Stories into Clearer Veterinary Intake Notes

Maribel L. Santos — Sun, 04 Oct 2026 21:24:29 +0000

This is a submission for the Hacktoberfest Weekend Challenge: Build for a Friend

What I Built

I built VetBrief, a lightweight veterinary intake and appointment request tool designed to help pet owners communicate more clearly with veterinary clinics.

I built it with a friend and veterinary-clinic context in mind.

When people are worried about an animal, they often explain what is happening in a long or unstructured way:

“She has been hiding since yesterday, she normally sleeps on the sofa, she did not eat breakfast, and she walked away when I tried to touch her.”

All of that information may be useful, but veterinary staff need to identify the key facts quickly.

VetBrief helps organise that information before the appointment.

The app collects:

basic patient information
main concern
onset and progression
appetite
water intake
vomiting
stool
urination
respiratory signs
activity and movement
additional observations
known medical conditions
medication and supplements

It then creates a structured veterinary brief.

For additional free-text observations, VetBrief uses an open-weight language model to turn the owner's description into a short, factual veterinary intake note.

The owner can then prepare an appointment request with a preferred date and time and attach the veterinary brief.

The goal is not to create an AI veterinarian.

The goal is much narrower:

help people organise what they have observed before speaking with a veterinary professional.

VetBrief does not diagnose, assess urgency, recommend treatment, or replace veterinary judgement.

Demo

Try VetBrief here:

https://vetbrief-maribele.streamlit.app/

The demo lets you:

complete a veterinary intake form
create a structured brief
use open-weight AI to structure free-text owner observations
prepare an appointment request

Code

GitHub repository:

https://github.com/Maribele/vetbrief

The repository includes:

the Streamlit application
setup instructions
dependency requirements
documentation
responsible-AI limitations
instructions for configuring the Hugging Face token securely

How I Built It

VetBrief is built with:

Python
Streamlit
Requests
Hugging Face Inference Providers
an open-weight language model
Git / GitHub

The structured intake form handles information that is easier and safer to collect directly through predefined fields.

The AI component is intentionally limited to one task:

transforming additional free-text owner observations into a concise, factual intake note.

For example:

Owner description

She has been hiding under the bed since yesterday. She normally sleeps on the sofa. She did not eat breakfast this morning and walked away when I tried to touch her.

AI-structured note

Hiding under the bed since yesterday (normally sleeps on the sofa)
Did not eat breakfast this morning
Walked away when approached for touch

The prompt explicitly instructs the model not to:

diagnose
assess urgency
recommend treatment
infer diseases
infer emotions or causes
invent information

That separation is important to the design of the project.

AI structures the information. Veterinary professionals interpret it.

Why Does Open Innovation Matter?

Open innovation matters for VetBrief because this kind of application may eventually handle sensitive information about animals, households, routines, and medical history.

Using an open-weight model makes it possible to explore future versions that could run locally inside a veterinary clinic.

That could give clinics greater control over:

privacy
deployment
model choice
data handling
cost
customisation
evaluation

A closed API can be convenient, but it gives less control over how the model is deployed and how the system may evolve.

For a veterinary context, I think the ability to inspect, compare, adapt, and potentially run models locally is especially valuable.

Open innovation also makes it easier to think critically about the role of AI.

In VetBrief, the model is not treated as an invisible decision-maker.

It is a replaceable component performing a narrow task.

That makes it easier to evaluate whether it is actually useful and whether another open model might perform better.

Prize Categories

Open-source AI / open-weight model