Vandersaag commited on
Commit
da1332a
Β·
verified Β·
1 Parent(s): e5c06a8

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +61 -8
README.md CHANGED
@@ -1,14 +1,67 @@
1
  ---
2
- title: Paddockai
3
- emoji: 🏒
4
- colorFrom: indigo
5
- colorTo: green
6
  sdk: gradio
7
- sdk_version: 6.14.0
8
- python_version: '3.13'
9
  app_file: app.py
10
- pinned: false
11
  license: apache-2.0
 
 
 
 
 
 
 
 
 
 
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: PaddockAI
3
+ emoji: πŸ„
4
+ colorFrom: green
5
+ colorTo: yellow
6
  sdk: gradio
7
+ sdk_version: "5.34.2"
 
8
  app_file: app.py
9
+ pinned: true
10
  license: apache-2.0
11
+ short_description: Instant livestock & pasture assessment from your phone
12
+ tags:
13
+ - agriculture
14
+ - livestock
15
+ - cattle
16
+ - pasture
17
+ - farming
18
+ - feedlot
19
+ - vision-language-model
20
+ - computer-vision
21
  ---
22
 
23
+ # πŸ„ PaddockAI
24
+
25
+ **Instant livestock & pasture assessment β€” right from your phone.**
26
+
27
+ Snap a photo of your cattle, paddock, or pasture and get an AI-powered assessment in seconds. Built for Australian farmers, feedlotters, and graziers β€” works worldwide.
28
+
29
+ ## What it does
30
+
31
+ | Assessment | What you get |
32
+ |---|---|
33
+ | πŸ„ **Cattle Health Check** | BCS, coat condition, eyes/nose, gait, respiratory, demeanour β€” with a health rating and action items |
34
+ | 🌿 **Pasture Condition** | Ground cover %, FOO (kg DM/ha), species composition, weed burden, grazing pressure, management recommendations |
35
+ | πŸ“Š **Body Condition Score** | Detailed 1–5 BCS with fat cover assessment over spine, ribs, hips, tailhead + target recommendations |
36
+ | πŸ”’ **Count Stock** | Headcount with confidence level, species/class ID, mob density assessment |
37
+ | πŸ₯ **Injury / Lameness** | Injury assessment with urgency rating, likely causes, and whether to call the vet |
38
+ | 🌾 **General Assessment** | Comprehensive overview of anything in the image |
39
+
40
+ ## How it works
41
+
42
+ 1. **Upload or snap a photo** (camera works on mobile)
43
+ 2. **Pick an assessment type**
44
+ 3. **Tap Analyze**
45
+ 4. Get a detailed, practical assessment in seconds
46
+
47
+ ## Tech
48
+
49
+ - **Model**: [Qwen3-VL-8B-Instruct](https://huggingface.co/Qwen/Qwen3-VL-8B-Instruct) β€” state-of-the-art vision-language model
50
+ - **Inference**: HuggingFace Inference API (serverless, no GPU needed on this Space)
51
+ - **UI**: Gradio with mobile-first design (big buttons, readable text)
52
+ - **Cost**: Free to run (CPU-only Space, model runs serverlessly)
53
+
54
+ ## ⚠️ Disclaimer
55
+
56
+ This is an **AI-powered visual assessment tool**, not a substitute for veterinary advice, agronomic consulting, or professional livestock assessment. Always consult qualified professionals for health concerns, management decisions, and regulatory compliance.
57
+
58
+ ## Setup (if deploying your own)
59
+
60
+ 1. Create a new HF Space (Gradio SDK)
61
+ 2. Upload `app.py` and `requirements.txt`
62
+ 3. Add your `HF_TOKEN` as a Space Secret (Settings β†’ Variables and secrets)
63
+ 4. The Space will start automatically on the free CPU tier
64
+
65
+ ## License
66
+
67
+ Apache 2.0