fenoh3ry/imaginarium

Imaginarium Madagascar — Immersive AI-assisted platform for Malagasy cultural heritage education # 🌺 Imaginarium Madagascar > *Tahiry ny lovantsofina — Heritage for the future* Imaginarium Madagascar is an immersive AI-assisted platform for **Malagasy cultural heritage education**. It teaches children about **fomba** (customs), **fahaizana** (skills), and **lova / lovantsofina** (heritage/ancestral wisdom) through interactive AI agents. ## 🏗 Architecture **Cloudflare-native MVP stack:** | Layer | Technology | Platform | |-------|-----------|----------| | Frontend | SvelteKit + adapter-cloudflare | Cloudflare Pages | | API | Hono | Cloudflare Workers | | Database | D1 (SQLite) | Cloudflare D1 | | AI | Workers AI | Cloudflare Workers AI | | Vectors | Vectorize | Cloudflare Vectorize | **Flat project structure** (no npm workspaces — avoids undici/Vite corruption): ``` imaginarium/ ├── apps/ │ ├── web/ # SvelteKit frontend │ └── api/ # Hono API (Workers) ├── data/ │ ├── schema/ # Content type definitions │ └── raw/ # Source texts for RAG ├── scripts/ # Data processing, embedding generation └── package.json # Scripts only, no workspaces ``` ## 📚 Content Types The knowledge base covers 9 core content types from Malagasy oral tradition: - **Angano** (tales/folklore) — traditional stories with moral lessons - **Ohabolana** (proverbs) — ancestral wisdom in concise form - **Hainteny** (poetry) — classical Malagasy poetic forms - **Kabary** (speeches) — formal oratory traditions - **Fomba** (customs) — cultural practices and rituals - **Fahaizana** (skills) — traditional crafts and knowledge - **Lova** (heritage) — ancestral inheritance and wisdom - **Ethnic groups** — the 18 peoples of Madagascar - **Historical figures** — key figures in Malagasy history ## 🚀 Getting Started ### Prerequisites - Node.js 18+ - Wrangler CLI - Cloudflare account with D1 + Workers AI enabled ### Setup ```bash # Clone the repo git clone github.com cd imaginarium # Install API dependencies cd …