README.md

metadata

sdk: gradio
colorFrom: green

🌐 LingScope — Cultural Expression & Language Comparison Assistant

LingScope helps you compare expressions between Korean and other languages (currently English and German), not just through translation, but by exploring how expressions differ in meaning, grammar, and cultural nuance.

✨ Features

• 🔤 Natural translation from Korean to English or German
• 🧠 Expression context and nuance explanation
• 🧩 Grammar structure breakdown
• 📚 Vocabulary spotlight with simple examples
• 🌍 Cultural insight into how phrases are perceived differently

🚀 How to Run on Hugging Face Spaces

1. Go to Hugging Face Spaces
2. Create a new Gradio space
3. Upload all files from this repo
4. Go to Settings > Secrets and add your OPENAI_API_KEY
5. Done! The app will automatically run

🧪 Example

Input:

고생했어! ("You worked hard!" / "It must've been tough!")

Output includes:

• 📖 Translated Expression
• 🧠 Explanation of nuance and context
• ⚙️ Grammar points (e.g., "must have + p.p.")
• 🗣️ Vocabulary explanation (e.g., tough, must have been)
• 🌍 Cultural difference note (e.g., "Direct appreciation isn't as common in English.")

🔧 Dependencies

transformers
torch
gradio
openai

🔭 Roadmap

• Add more target languages (Japanese, French, etc.)
• Let users save & review previous expressions
• Add pronunciation (TTS) for each expression

© 2025 LingScope Project — Designed & developed by Eunyeong