An AI-powered web platform that preserves and promotes African languages and culture through translation, voice narration, stories, and games.
# cultura-ai
An AI-powered web platform that preserves and promotes African languages and culture through translation, voice narration, stories, and games.
## 📁 Project Directory Structure
```
cultura-ai/
│
├── README.md
├── LICENSE
├── .gitignore
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
│
├── docs/
│ └── user-guide.md
│
├── src/
│ ├── App.jsx
│ └── index.js
│
├── tests/
│ └── test_translation.js
│
├── requirements.txt
│
└── .github/
└── workflows/
└── ci.yml
```
---
## 🌟 Key Features
- 🗣️ **Voice-Based Translation**: Translate between English, Swahili, Kikuyu, and Luo — with authentic voice narration
- 📖 **Story Explorer**: Listen to folktales narrated in local voices
- 🎮 **Game Hub**: Play language-learning games (flashcards, quizzes, matchers)
- ✍️ **Submit Your Story**: Contribute your own stories and share cultural heritage
- 📁 **My Library**: Save stories, favorite phrases, and track learning progress
- 🔒 **Guest Mode**: Learn without logging in — accessible to all users
- 🌐 **Offline Ready**: Access key content in low-connectivity areas
---
## 🚀 Installation
##
### 1. Clone the repositorygit clone
github.com
git clone
github.com
cd cultura-ai
---
## 📝 Usage Examples
Translate a Phrase
Type: “Hello” → Select “Kikuyu”
Cultura AI: “Wî mwega” (audio plays)
Listen to a Story
Go to Story Explorer
Choose “Why the Hare Has Long Ears”
Listen to narration in Kamba
Play a Game
Go to Game Hub
Select Flashcard Game — match words and meanings
---
## 🤝 Contribution Guide
We welcome contributions from developers, linguists, educators, and community members!
Fork this repository
Create a new branch: git checkout -b feature/my-feature
Make your changes
Commit with a clear message: feat: add story submission form
Push: git push origin feature/my-feature
Open a Pull Request
Please read the CONTRIBUTING.md for details on our code style, testing guidelines, and …