{"id":21279836,"url":"https://github.com/abderrahmane-stack/voice-assistan","last_synced_at":"2025-03-15T13:45:02.618Z","repository":{"id":252387991,"uuid":"840286720","full_name":"abderrahmane-stack/voice-assistan","owner":"abderrahmane-stack","description":"A Python-based voice assistant designed to automate daily activities. This assistant can perform tasks such as searching Wikipedia, opening applications like Notepad and Paint, sending emails, and opening frequently used websites. It aims to streamline daily tasks through voice commands, enhancing productivity and convenience.","archived":false,"fork":false,"pushed_at":"2024-08-10T10:33:38.000Z","size":56335,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T04:09:19.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abderrahmane-stack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-09T11:19:15.000Z","updated_at":"2024-08-30T00:00:02.000Z","dependencies_parsed_at":"2024-11-21T10:28:49.796Z","dependency_job_id":"cc42c7f2-ec6b-496f-8326-dfd0f0756fb3","html_url":"https://github.com/abderrahmane-stack/voice-assistan","commit_stats":null,"previous_names":["abderrahmane-stack/voice-assistan"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abderrahmane-stack%2Fvoice-assistan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abderrahmane-stack%2Fvoice-assistan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abderrahmane-stack%2Fvoice-assistan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abderrahmane-stack%2Fvoice-assistan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abderrahmane-stack","download_url":"https://codeload.github.com/abderrahmane-stack/voice-assistan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243738955,"owners_count":20339997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T10:26:39.398Z","updated_at":"2025-03-15T13:45:02.588Z","avatar_url":"https://github.com/abderrahmane-stack.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Voice Assistant\n\nA Python-based voice assistant that automates various tasks, such as searching Wikipedia, opening applications, and sending emails.\n\n## Features\n\n- **Speech Recognition**: Converts spoken language into text for command processing.\n- **Text-to-Speech**: Provides vocal responses to your commands.\n- **Application Control**: Opens commonly used applications like Notepad and Paint.\n- **Web Search**: Retrieves information from Wikipedia and opens websites.\n- **Email Sending**: Sends emails using Gmail.\n\n## Setup\n\n### 1. Clone the Repository\n\nFirst, clone the repository to your local machine:\n\n```bash\ngit clone https://github.com/abderrahmane-stack/voice-assistan.git\n```\n\n### 2. Navigate to the Project Directory\n\nMove into the project directory:\n\n```bash\ncd voice-assistan\n```\n\n### 3. Set Up a Virtual Environment (Optional but Recommended)\n\nIt's recommended to create a virtual environment to manage dependencies:\n\n```bash\npython -m venv venv\n```\n\nActivate the virtual environment:\n\n- On Windows:\n  ```bash\n  venv\\Scripts\\activate\n  ```\n- On macOS/Linux:\n  ```bash\n  source venv/bin/activate\n  ```\n\n### 4. Install Dependencies\n\nCreate a `requirements.txt` file in your project directory with the following content:\n\n```\npyttsx3\nSpeechRecognition\nwikipedia\n```\n\nThen, install the required packages:\n\n```bash\npip install -r requirements.txt\n```\n\n## Usage\n\n### 1. Run the Script\n\nTo start the voice assistant, run:\n\n```bash\npython voice_assistant.py\n```\n\n### 2. Interact with the Assistant\n\nFollow the voice prompts to interact with the assistant. You can issue commands like:\n\n- \"Search Wikipedia for [topic].\"\n- \"Open Notepad.\"\n- \"Send email to [email address].\"\n\n## Configuration\n\n### Update Email Credentials\n\nTo enable email functionality, you need to update your email credentials in `voice_assistant.py`:\n\n```python\nsender_email = 'your-email@gmail.com'\napp_password = 'your-app-password'\n```\n\n**Note:** If two-factor authentication is enabled on your Gmail account, you must use an App Password. You can generate one from your Google Account settings.\n\n### Specify Recipient Email\n\nWhen using the email feature, ensure that you specify the recipient's email address:\n\n```python\nto_email = 'recipient@example.com'\n```\n\n## Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests to improve this project.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabderrahmane-stack%2Fvoice-assistan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabderrahmane-stack%2Fvoice-assistan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabderrahmane-stack%2Fvoice-assistan/lists"}