title	Kawsay — Conocimiento Vivo
emoji	🌿
colorFrom	green
colorTo	yellow
sdk	gradio
sdk_version	5.0
app_file	app.py
pinned	true
license	apache-2.0
short_description	Multimodal AI for Quechua/Aymara bilingual education + Andean bioindicators

Kawsay — Conocimiento Vivo / Living Knowledge

"When a language dies, a climate system dies with it."

Multimodal AI for Quechua and Aymara bilingual education and Andean ecological knowledge preservation, powered by Gemma 4.

---

What is Kawsay?

A teacher in a rural Andean school photographs a toad. Kawsay recognizes it, generates a bilingual lesson in Spanish and Quechua, and explains that this toad (jamp'atu) is a documented climate bioindicator — a dark back predicts a rainy year. The lesson includes audio pronunciation in the indigenous language, vocabulary with cultural context, and citations from peer-reviewed research.

This is not a translator. It is a knowledge bridge.

---

Live Demo

Try Kawsay on HuggingFace Spaces →

Android APK — Gemma 4 on-device, offline →

---

Why Gemma 4?

Capability	How Kawsay uses it
Multimodal vision	Photo → bilingual lesson with ecological context
Native function calling	3 tools: bioindicator KB, dictionary, cultural context
Multilingual generation	Simultaneous Spanish + Quechua/Aymara output

---

Architecture

Photo + Language
      ↓
Gemma 4 E4B-it (4-bit, ~5 GB VRAM on T4)
      ↓ function calling loop (≤3 rounds)
      ├─ lookup_bioindicator()   → 31 bioindicators (Orlove et al. 2000)
      ├─ translate_word()        → 131 bilingual entries
      └─ get_cultural_context()  → Pachamama, ayni, ayllu
      ↓
Bilingual lesson (Markdown)
      ↓
Meta MMS-TTS → Audio in Quechua (mms-tts-quz) or Aymara (mms-tts-ayr)

Android app — fully offline after first setup:

Gemma 4 E2B (LiteRT) on-device
4 screens: Home · Simi (dictionary) · Pacha (bioindicators) · Yachay (SRS quiz)

---

Knowledge Base

Dataset	Size	Source
Bioindicators	31 entries	Orlove et al. Nature 2000, Van Kessel 2002, Claverias 2003
Dictionary (QU)	81 entries	AULEX, Iskay Simipi Yuyayk'ancha
Dictionary (AY)	50 entries	AULEX
Tinkuy variants	15 concepts × 5 dialects	Original research
Cultural concepts	11 entries	PRATEC, Estermann 2006

---

Quick Start

Gradio demo (CPU/GPU auto-detect)

git clone https://github.com/Prometeodev/kawsay
cd kawsay
pip install -r requirements.txt
python app.py

Kaggle (T4 GPU — full Gemma 4)

Open notebooks/kawsay_kaggle.ipynb with GPU accelerator enabled.

Android APK (offline)

Download from Releases. Open app → Gemma 4 downloads automatically (~1.5 GB) → works forever offline.

Tests

PYTHONPATH=src pytest tests/ -v         # Python: 136 tests
cd android && flutter test test/        # Flutter: 60+ tests

---

Project Structure

kawsay/
├── app.py                  HF Spaces entry point
├── config.yaml             All configuration
├── src/kawsay/
│   ├── model/              Gemma 4 inference + function calling
│   ├── knowledge/          Bioindicator KB, dictionary KB
│   ├── audio/              Meta MMS-TTS (qu/ay)
│   └── app/                Gradio UI + handlers
├── android/                Flutter Android app (Gemma 4 E2B on-device)
├── data/                   Knowledge JSON files
├── notebooks/kawsay_kaggle.ipynb
└── tests/                  136 pytest tests

---

Ethics & Data Sovereignty

Follows CARE Principles for Indigenous Data Governance: community corrections accepted with dialect metadata, explicit dialect declaration, no user data stored, all processing local on Android.

---

References

• Orlove, B.S. et al. (2000). Forecasting Andean rainfall using the stars. Nature, 403, 68–71.
• Van Kessel, J. & Enríquez, D. (2002). Señas y señaleros de la Madre Tierra. IECTA.
• Claverias, R. (2003). Cosmovisión y planificación en comunidades andinas. CIED.
• PRATEC (multiple years). Andean agricultural technology documentation.

---

Built for the Gemma 4 Good Hackathon 2026 · Track: Digital Equity & Inclusivity Kawsay = "life" in Quechua