Educational Voice Assistant Documentation

Overview

The Educational Voice Assistant is a web-based application that combines voice recognition, speech synthesis, and Wikipedia data retrieval to assist users in learning, exploring, and discovering new knowledge.

New Features

• Typed Commands: In addition to voice, users can type commands in the input box and submit with Enter or the submit button.
• Dark Mode Toggle: Users can switch between light and dark themes.
• Clear Output: A quick action to clear response text, spoken text, and command history.
• Command History: The app stores the latest commands with timestamps and source (voice or typed).
• Repeat Command: Users can say or type repeat to hear the latest assistant response again.
• Wikipedia Fallback: If local PHP endpoints are unavailable, the app falls back to the public Wikipedia API so learning commands still work.

Existing Core Features

• Voice Interaction: Start and stop voice listening using on-screen controls.
• Commands: Supports greetings, self-introduction, and Teach me about [topic] to fetch Wikipedia summaries.
• Speech Synthesis: Assistant responses are spoken aloud and shown in the UI.
• Wikipedia Integration: Uses search-wikipedia.php and get-summary.php when available.

Running the App

Option 1 (Recommended): PHP server (uses local endpoints)

php -S 127.0.0.1:8080

Then open:

http://127.0.0.1:8080/index.html

Option 2: Static server

You can still run with a static server. In this mode, Wikipedia lookups use the public API fallback.

python3 -m http.server 8080

Then open:

http://127.0.0.1:8080/index.html

Usage

1. Open the app in a browser.
2. Click Start Listening and speak a supported command, or type a command in the text box.
3. Try:
   • hello
   • teach me about photosynthesis
   • tell me about yourself
   • repeat
   • stop
4. Use Toggle Dark Mode and Clear Output for quick UI controls.

© Atharv Shinde | TechCognita