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

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:

1. complete a veterinary intake form
2. create a structured brief
3. use open-weight AI to structure free-text owner observations
4. 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