Talk

An AI-powered IELTS Speaking practice platform that provides real-time feedback, evaluation, and scoring.

Online · Report Bug · Request Feature

✨ Features

• 🎯 Real-time IELTS speaking practice for all three parts
• 🎙️ Voice recording with automatic transcription
• 🤖 AI-powered evaluation and scoring
• 💡 Detailed feedback on pronunciation, grammar, and vocabulary
• 🔊 Text-to-Speech for reference answers
• 📊 Band score calculation following official IELTS criteria
• 🎨 Modern and responsive UI with dark mode support

🚀 Getting Started

Prerequisites

• Node.js 20+
• pnpm
• OpenAI API key

Installation

1. Clone the repository

git clone https://github.com/dustland/talk.git

2. Install dependencies

pnpm install

3. Set up environment variables

cp .env.example .env.local

Add your OpenAI API key to .env.local:

OPENAI_API_KEY=your_api_key_here

4. Run the development server

pnpm dev

Open http://localhost:3000 with your browser to see the result.

🛠️ Tech Stack

• Next.js 15 - React framework
• TypeScript - Programming language
• Tailwind CSS - CSS framework
• Shadcn/ui - UI components
• OpenAI API - AI models (GPT-4o, Whisper, TTS)
• Framer Motion - Animations

📖 Usage

1. Select Speaking Part: Choose between Part 1 (Introduction), Part 2 (Long Turn), or Part 3 (Discussion)
2. Start Recording: Click the "Start Speaking" button to begin recording your answer
3. Stop Recording: Click "Stop Recording" when finished
4. Review Feedback:
   • View your transcribed answer
   • See detailed AI feedback
   • Check your band scores
   • Listen to a reference answer

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• OpenAI for providing the AI models
• Vercel for hosting
• Shadcn for the amazing UI components
• IELTS speaking test format and criteria

📧 Contact

Dustland - @dustland_ai - [email protected]

Project Link: https://github.com/dustland/talk

---

Made with ❤️ for IELTS learners and AI enthusiasts