📖 Τεκμηρίωση (README)
Helpistos (Ήλπιστος) 🤖
Ο Helpistos είναι ένας φορητός φωνητικός βοηθός (Voice Assistant) στα Ελληνικά, σχεδιασμένος να εκτελεί διάφορες εργασίες μέσω φωνητικών εντολών. Μπορεί να χρησιμοποιηθεί σε υπολογιστή αλλά είναι έτοιμος και για μεταφορά σε Android μέσω του Flet/Toga frameworks.
🚀 Λειτουργίες
- 🔊 Μετατροπή Κειμένου σε Ομιλία (TTS): Χρησιμοποιεί το gTTS για να “μιλάει” ελληνικά.
- 🎤 Αναγνώριση Φωνής: Κατανοεί ελληνικές φωνητικές εντολές μέσω της Google Speech Recognition.
- 🕒 Ώρα και Ημερομηνία: Σας ενημερώνει για την τρέχουσα ώρα και ημερομηνία στα ελληνικά.
- 🌦️ Πρόγνωση Καιρού: Παρέχει πληροφορίες για τον καιρό σε οποιαδήποτε πόλη (μέσω Open-Meteo API).
- 📰 Ειδήσεις: Διαβάζει τους κυριότερους τίτλους ειδήσεων από το Google News Greece.
- 📚 Βικιπαίδεια: Αναζητά και διαβάζει περιλήψεις από την ελληνική Wikipedia.
- ⌨️ Αυτόματη Πληκτρολόγηση: Μπορεί να γράψει ό,τι του λέτε σε οποιοδήποτε ενεργό πεδίο κειμένου (χρησιμοποιώντας το πρόχειρο και εξομοίωση πληκτρολογίου).
🛠️ Εγκατάσταση
- Προαπαιτούμενα:
- Python 3.12 ή νεότερη.
-
uv (προτείνεται για τη διαχείριση πακέτων).
-
Εγκατάσταση εξαρτήσεων:
bash
uv sync -
Εξωτερικές βιβλιοθήκες που χρησιμοποιούνται:
SpeechRecognition: Για την αναγνώριση φωνής.gTTS: Για την παραγωγή ομιλίας.playsound: Για την αναπαραγωγή των αρχείων ήχου.wikipedia: Για την αναζήτηση πληροφοριών.requests&BeautifulSoup4: Για την ανάκτηση καιρού και ειδήσεων.pyperclip&pynput: Για τη λειτουργία αυτόματης πληκτρολόγησης.
🎤 Χρήση
Εκτελέστε το script:
python voice_assistant.py
Ο βοηθός θα σας πει “Έλα μου. Τι θες;” και θα αρχίσει να ακούει. Μερικές εντολές που μπορείτε να δώσετε:
– “Τι ώρα είναι;”
– “Πες μου τον καιρό” (θα σας ρωτήσει για ποια πόλη).
– “Πες μου τα νέα” ή “Πες μου τις ειδήσεις”.
– “Βρες [θέμα]” (π.χ. “Βρες την Αθήνα”) για αναζήτηση στη Βικιπαίδεια.
– “Γεια” για έναν απλό χαιρετισμό.
– “Τέλος”, “Έξοδος” ή “Στοπ” για να τερματίσετε την εφαρμογή.
Οτιδήποτε άλλο πείτε, ο Helpistos θα προσπαθήσει να το πληκτρολογήσει εκεί που βρίσκεται ο κέρσοράς σας.
📄 Άδεια Χρήσης
Αυτό το project διατίθεται υπό την άδεια MIT.
📂 Δομή Κώδικα & Αρχείων
📁 .briefcase-venv
📁 bin
📄 Activate.ps1
📄 activate
📄 activate.csh
📄 activate.fish
📄 briefcase
📄 chardetect
📄 cookiecutter
📄 httpx
📄 markdown-it
📄 normalizer
📄 pip
📄 pip3
📄 pip3.12
📄 pygmentize
📄 pyproject-build
📄 python
📄 python3
📄 python3.12
📄 slugify
📄 wheel
📁 lib
📁 python3.12
📁 site-packages
📄 81d243bd2c585b0f4821__mypyc.cpython-312-x86_64-linux-gnu.so
📁 _distutils_hack
📄 __init__.py
📄 override.py
📁 _yaml
📄 __init__.py
📁 anyio-4.13.0.dist-info
📄 INSTALLER
📄 METADATA
📄 RECORD
📄 WHEEL
📄 entry_points.txt
📁 licenses
📄 LICENSE
📄 top_level.txt
📁 anyio
📄 __init__.py
📁 _backends
📄 __init__.py
📄 _asyncio.py
📄 _trio.py
📁 _core
📄 __init__.py
📄 _asyncio_selector_thread.py
📄 _contextmanagers.py
📄 _eventloop.py
📄 _exceptions.py
📄 _fileio.py
📄 _resources.py
📄 _signals.py
📄 _sockets.py
📄 _streams.py
📄 _subprocesses.py
📄 _synchronization.py
📄 _tasks.py
📄 _tempfile.py
📄 _testing.py
📄 _typedattr.py
📁 abc
📄 __init__.py
📄 _eventloop.py
📄 _resources.py
📄 _sockets.py
📄 _streams.py
📄 _subprocesses.py
📄 _tasks.py
📄 _testing.py
📄 from_thread.py
📄 functools.py
📄 lowlevel.py
📄 py.typed
📄 pytest_plugin.py
📁 streams
📄 __init__.py
📄 buffered.py
📄 file.py
📄 memory.py
📄 stapled.py
📄 text.py
📄 tls.py
📄 to_interpreter.py
📄 to_process.py
📄 to_thread.py
📁 arrow-1.4.0.dist-info
📄 INSTALLER
📄 METADATA
📄 RECORD
📄 WHEEL
📁 licenses
📄 LICENSE
📁 arrow
📄 __init__.py
📄 _version.py
📄 api.py
📄 arrow.py
...
[Truncated, total 3201 items]
🚀 Εκδόσεις & Releases
Published: 19 Apr 2026, 23:44
Instruction Guide: Added the ‘πες τα όλα’ command to list all available voice functions, helping users discover and learn the assistant’s capabilities.
- ⬇️ helpistos-v164.apk (73.32 MB)
Published: 16 Apr 2026, 16:54
Stability fixes for Audio and Search: Implemented serial speech execution to prevent audio file conflicts and added support for accented voice commands in Wikipedia/News search triggers.
- ⬇️ helpistos-v163.apk (73.32 MB)
Published: 15 Apr 2026, 23:18
Targeted News Search: Added the ‘Πες μου τι ξέρεις για [θέμα]’ command to search Google News for specific topics and read out the top 5 headlines.
- ⬇️ helpistos-v162.apk (73.32 MB)
Published: 15 Apr 2026, 12:48
Lifecycle and Autostart Fixes: Implemented native Android exit (finishAffinity) to fully close the app when ‘τέλος’ is said. Added autostart listening logic to trigger ‘on_listen_press’ 2 seconds after the app launches.
- ⬇️ helpistos-v161.apk (73.32 MB)
Published: 14 Apr 2026, 19:33
Greek Wikipedia integration and UI Cleanup: Implemented ‘βρες’ command using the Wikipedia API and filtered technical [DEBUG] logs for a cleaner user experience.
- ⬇️ helpistos-v160.apk (73.32 MB)