Skip to content

dustland/talk

Repository files navigation

IELTS Speaking Master

Talk

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

License: MIT Next.js OpenAI TypeScript

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
  1. Install dependencies
pnpm install
  1. Set up environment variables
cp .env.example .env.local

Add your OpenAI API key to .env.local:

OPENAI_API_KEY=your_api_key_here
  1. Run the development server
pnpm dev

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

🛠️ Tech Stack

📖 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 - hi@dustland.ai

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


Made with ❤️ for IELTS learners and AI enthusiasts