ReadMando — Turn Stories into Fluency

Live Demo → ReadMando

---

Overview

ReadMando is an AI-powered learning platform that helps Mandarin Chinese learners build reading comprehension and vocabulary knowledge through interactive, personalized short stories. Learners can explore, create, and master Mandarin Chinese, one story at a time.

---

Core Features

Story Generator

• Customizable Stories
  Choose your story’s difficulty, length, and theme. Insert specific vocabulary you want to practice!

• Built-In Comprehension Questions
  Every story ends with auto-generated questions to help you reinforce what you just read.

• Text-to-Speech (TTS)
  Hear native-like pronunciation while reading. Powered by edge-tts for high-quality Mandarin audio playback.

• Instant Vocabulary Lookup
  Click on any word to view its pinyin, English translation, and part-of-speech tag. Built using the Jieba segmentation library.

• Unknown Word Detection
  The system automatically detects and annotates unfamiliar words with predicted definitions.

---

Vocabulary Flashcards

• Automatically add any words from your stories into your study deck.
• Review at your own pace using custom flashcards with pinyin, definitions, and part of speech.
• Designed to support spaced repetition and personalized practice.

---

Search Bar

• Search by Mandarin or English using the search bar.
• Supports partial matches to help you find relevant vocabulary.
• Directly add any word to your personalized vocabulary deck.

---

Dictionary

• Explore a Chinese -> English dictionary of over 7000 words
• Infinite scrolling (doomscroll to your heart's content)
• Directly add any word from the dictionary page to your personalized vocabulary deck.

Story Hub

• Browse a growing library of stories created by other learners.
• Revisit your past generated stories and upvote stories you like.
• See what stories other people are reading.

---

Architecture & Deployment

The backend is built with FastAPI, containerized using Docker, and deployed with Fly.io:

• Core Backend
  • Story generation
  • Vocabulary processing and storage
  • User authentication and session handling
  • Supabase integration for data storage
  • Text-to-Speech

---

Feedback & Contributions

Got an idea to improve ReadMando? Feel free to reach out via email.