Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

🗣️ TeachSimple Voice AI

TeachSimple Voice AI is an interactive voice-based assistant designed to provide a smooth and engaging learning experience. Powered by OpenAI's real-time API, it listens to users, responds with natural voice outputs, and guides them through personalized conversations.

💡 Why TeachSimple?
Learning should be simple, engaging, and conversational. TeachSimple brings this philosophy to life with a voice-driven interface that feels like chatting with a real human assistant.


🚀 Features

✅ Real-time voice interaction with OpenAI's Realtime API Key
✅ Smooth, human-like conversational flow with polite introductions and gratitude
✅ Beautiful and responsive UI with animated bubbles and live indicators
✅ Always-listening mode—no need to click to speak
✅ Lightweight and easy to set up locally


🎥 Demo

🚧 Demo video coming soon! 🚧


🛠️ Tech Stack

  • Frontend: HTML, CSS, JavaScript (Vanilla JS, WebRTC for audio streaming)
  • Backend: Node.js, Express.js
  • AI Integration: OpenAI Realtime API
  • Voice Streaming: WebRTC & OpenAI Audio Streams

📦 Installation & Setup

  1. Clone the Repository:

  2. Install Dependencies:

  • npm install
  1. Create a .env File:

    Add your OpenAI API key in a .env file at the project root:

  • OPENAI_API_KEY=your-openai-api-key
  1. Run the Application:
  • node server.js
  1. Access the App:
    Open your browser and navigate to http://localhost:3000 🎧

🎨 UI Preview

✅ Pulsing voice bubble that reacts when AI is listening or speaking
✅ Row of animated dots indicating active listening mode
✅ Top-left logo for a branded app feel


🤝 Contributing

Contributions are welcome! Feel free to fork the repository, make enhancements, and submit pull requests.

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

🛡️ License

This project is licensed under the MIT License.


🙌 Acknowledgments

Special thanks to the OpenAI team for providing powerful AI models and real-time voice APIs that make conversational learning possible.


🚀 Future Enhancements

  • 🌍 Add multi-language support
  • 🎙️ Enable customizable voices & accents
  • 📊 User analytics for personalized learning suggestions
  • 🗒️ Conversation history tracking

❤️ Support

If you like the project, give it a ⭐️ on GitHub and share it with your network!


About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages