Skip to content

OBRATEN/Jhosh-assistent

Repository files navigation

			Документация
			____________


	*
	* Добрый день, пользователь!
	* Данный проект был создан мною по давним мечтам и идеям.
	* Я всегда хотел иметь автоматического помощника,
	* А теперь мои идеи получилось воплотить в реальность.
	* С уважинием,
	* 	Разработчик
	*



			Описание работы
			_______________

	*
	* Проект полностью выполнен для Debian GNU/Linux.
	* Язык написания - Python3
	* Целью данного проекта служит проверка знаний и опыта, разработка полезного приложения
	* "Jhosh" скорее можно отнести к классу социальных приложений, так как является программой-ассистентом
	* Персонализирование Джоша возможно при помощи простых редакций кода:
	# В словарь команд стоит лишь ввести новый элемент,
	# А в функцию "execution" вписать условие.
	* Вывод осуществляется в оболочку терминала, так как это вполне уместно для Linux-подобных систем.
	* В будущем планируется перенести вывод в окно при помощи QT5 или GTK4
	* 



			Системные требования
			____________________

	*
	* Debian Linux/Ubuntu Linux/Linux Mint/Kali linux/Другие форки Debian
	* ALSA
	* Python3.8
	* PyAudio 0.2.11
	* Pyttsx3 2.90
	* Speech_recognition
	* Fuzzywuzzy 0.18.0
	* Устройство голосового ввода
	* bash/sh/zsh оболочка терминала
	*


			Рекомендации
			____________

	*
	* Возможно, что он будет дополняться.
	* Возможно, что будут возникать проблемы на других системах.
	* Не помешало бы иметь синтезатор речи с поддержкой русского языка.
	* Необходимо иметь микрофон для ввода аудио.
	* Номер микрофона можно узнать при помощи micro.sh (Код .py файла взят со страницы на PyPI) или самостоятельно.
	* 



			Использовано
			____________

	*
	* Проект имеет открытый исходный код и вы можете проверить информацию вручную.
	* Использованы библиотеки:
	# Pyttsx3, webbrowser, sys, speech_recognition, time, fuzzywuzzy, datatime.
	* Описание каталогов:
	# "source" содержит в себе .py файлы кода, необходимые для запуска .sh скриптов
	# "kod" содержит в себе полный код исходных вайлов в формате .txt
	*



			Для установки
			_____________
	*
	# Если вы не хотите вручную устанавливать пакеты,
	# то воспользуйтесь ./installer_ubuntu.sh
	# Этот скрипт установит все пакеты за вас.
	# Если после этого обнаружилась ошибка в отсутствии пакета,
	# то установите этот пакет самостоятельно.



			Список команд
			_____________


	*
	* Команды:
	# Скажите в начале команды "Джош" или похожие имена
	# После скажите одну из команд:
	# Попросите открыть сайт, рассказать анекдот, спросите время.
	* Примеры:
	# Джош, сколько сейчас времени?
	# Джош, открой ютуб
	# Джош, расскажи анекдот
	# Джош, назови случайное число
	* Джош может преобразовать речь максимально близко к правильному варианту.
	*







About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published