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 โฆ