An AI-powered Progressive Web App that helps you improve your English through voice conversations. Get real-time corrections, track your mistakes, and receive personalized learning tips!
- Speak naturally - Just tap the mic and speak in English
- Real-time transcription - See what you said instantly
- AI corrections - Get immediate feedback from Claude AI
- Voice responses - Hear the correct pronunciation
- Multiple sessions - Organize conversations by topic
- Comprehensive table - All your mistakes in one place
- Search & filter - Find specific mistakes by category
- Export to CSV - Download your learning history
- Categories: Grammar, Vocabulary, Style, Pronunciation
- Proficiency levels - Beginner, Intermediate, Advanced
- Common mistakes - See your most frequent errors
- Grammar tips - Level-appropriate grammar lessons
- Vocabulary suggestions - Expand your word knowledge
- Progress tracking - Monitor your improvement
- Anthropic API Key - Get one from https://console.anthropic.com/
- Modern browser - Chrome recommended (for best voice recognition)
- Microphone - For voice input
-
Start a local server:
cd /home/sowmyasb/Downloads/english-teacher-app python3 -m http.server 8080 -
Open in browser:
- Desktop:
http://localhost:8080 - Phone:
http://YOUR_IP:8080(find IP withhostname -I)
- Desktop:
-
Enter API Key:
- On first launch, you'll be prompted for your Anthropic API key
- It's saved securely in your browser's local storage
-
Access from phone:
- Make sure phone and computer are on same WiFi
- Open Chrome on your phone
- Go to
http://YOUR_COMPUTER_IP:8080
-
Install the app:
- Tap the menu (⋮) in Chrome
- Select "Install app" or "Add to Home Screen"
- App icon appears on your home screen!
-
Use like a native app:
- Tap icon to open
- Grant microphone permission
- Start speaking!
Using GitHub Pages:
# Create a new repository on GitHub
# Upload all files from english-teacher-app/
# Enable GitHub Pages in repository settings
# Access at: https://yourusername.github.io/repo-nameUsing Netlify:
- Go to https://netlify.com
- Drag the
english-teacher-appfolder - Get instant URL:
https://your-app.netlify.app
- Tap the microphone button 🎤
- Speak your sentence in English
- Wait for AI analysis (2-3 seconds)
- Review the correction if any mistakes found
- Listen to proper pronunciation 🔊
- Continue the conversation
- View sessions: Tap "📚 Today's Practice" button
- Create new: Tap "+ New" button
- Switch sessions: Tap any session in the sidebar
- Delete sessions: Tap the × button (can't delete last session)
- View all mistakes: Automatically populated as you chat
- Search: Type keywords to find specific mistakes
- Filter: Select category (Grammar, Vocabulary, etc.)
- Export: Download CSV file of all mistakes
- Delete: Remove individual mistake records
- Select your level: Beginner, Intermediate, or Advanced
- View common mistakes: See your most frequent error types
- Read grammar tips: Level-appropriate lessons
- Learn vocabulary: Suggested words for your level
- Track progress: See total sessions, mistakes, and messages
- Frontend: HTML5, CSS3, JavaScript (ES6+)
- AI: Anthropic Claude 3.5 Sonnet API
- Voice: Web Speech API (recognition) + Speech Synthesis API
- Storage: LocalStorage for sessions and mistakes
- PWA: Service Worker for offline capability
- ✅ Chrome/Edge (Recommended) - Full support
- ✅ Safari - Works, but voice recognition may vary
⚠️ Firefox - Limited voice recognition support- ❌ Opera - Not recommended
- Local only - All data stored in browser's LocalStorage
- No cloud sync - Data stays on your device
- Privacy first - No tracking or analytics
- API calls - Only to Anthropic for AI corrections
- Model: Claude 3.5 Sonnet
- Cost: ~$0.003 per message (very affordable)
- Example: 100 messages = ~$0.30
- Your API key - You control usage and costs
- Practice speaking before exams
- Improve pronunciation
- Learn from mistakes
- Build confidence
- Prepare for presentations
- Improve business English
- Practice interviews
- Enhance communication skills
- Daily practice routine
- Track progress over time
- Identify weak areas
- Get personalized tips
- ✅ No data collection - We don't collect any data
- ✅ Local storage - Everything stays on your device
- ✅ API key security - Stored locally in browser
- ✅ No tracking - No analytics or cookies
- ✅ Open source - Review the code yourself
- Check permissions: Allow microphone access in browser
- Check hardware: Test mic in other apps
- Try Chrome: Best voice recognition support
- Check API key: Make sure it's valid and active
- Check credits: Ensure you have API credits
- Check internet: API requires internet connection
- Speak clearly: Enunciate words
- Reduce noise: Find quiet environment
- Use Chrome: Best browser for voice recognition
- Check language: Set to English (US)
- Use Chrome: Other browsers may not support PWA install
- Check HTTPS: Some features require secure connection
- Try "Add to Home Screen": Manual installation option
Future enhancements (not yet implemented):
- Cloud sync across devices
- Conversation topics/scenarios
- Pronunciation scoring
- Vocabulary flashcards
- Achievement badges
- Social sharing
- Multiple language support
This is a personal learning tool, but feel free to:
- Fork and customize for your needs
- Report bugs or issues
- Suggest new features
- Share improvements
Free to use and modify for personal and educational purposes.
- Anthropic - For the amazing Claude AI
- Web Speech API - For voice recognition
- You - For improving your English!
- Practice daily - Even 5 minutes helps
- Review mistakes - Learn from corrections
- Use sessions - Organize by topic
- Export data - Keep records of progress
- Adjust level - Match tips to your proficiency
Happy Learning! 🎓📚