{"id":27163061,"url":"https://github.com/codeintrovert/gdg-apl-one","last_synced_at":"2025-04-09T01:40:59.049Z","repository":{"id":285148491,"uuid":"957208271","full_name":"codeIntrovert/GDG-APL-ONE","owner":"codeIntrovert","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-29T20:14:52.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T21:22:21.256Z","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/codeIntrovert.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":"2025-03-29T20:07:34.000Z","updated_at":"2025-03-29T20:14:56.000Z","dependencies_parsed_at":"2025-03-29T21:22:23.223Z","dependency_job_id":"bc60fdda-2e83-4b43-a4da-42425ccfea1c","html_url":"https://github.com/codeIntrovert/GDG-APL-ONE","commit_stats":null,"previous_names":["codeintrovert/gdg-apl-one"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeIntrovert%2FGDG-APL-ONE","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeIntrovert%2FGDG-APL-ONE/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeIntrovert%2FGDG-APL-ONE/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codeIntrovert%2FGDG-APL-ONE/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codeIntrovert","download_url":"https://codeload.github.com/codeIntrovert/GDG-APL-ONE/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247958720,"owners_count":21024821,"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":"2025-04-09T01:40:57.912Z","updated_at":"2025-04-09T01:40:59.032Z","avatar_url":"https://github.com/codeIntrovert.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VOICE AND TEXT-BASED ALEXA CLONES USING GEMINI\n\nThis project provides both **voice-based** and **text-based** AI assistants using **Google's Gemini API**. The AI-powered assistants can process user input via text or speech and generate intelligent responses.\n\n## **Skill Tags**\n\nPython, APIs, Google Gemini API, AI, Voice Recognition, Speech-to-Text, Text-to-Speech (TTS), Voice Assistant, Automation, Speech Synthesis\n\n## **Relevant Links**\n\nVisual Studio Code: https://code.visualstudio.com/\nPython: https://www.python.org/downloads/\n\n---\n\n## **Getting Started**\n\nFollow these steps to set up and run the project on your local machine.\n\n### **1. Clone the Repository**\n\nFirst, clone or download the project from the GitHub repository:\n\n```bash\n git clone https://github.com/codeIntrovert/GDG-APL-ONE\n cd GDG-APL-ONE\n```\n\n### **2. Get a Free Gemini API Key**\n\nYou need an API key from **Google's AI Studio** to use the Gemini AI services.\n\n- Visit [Google AI Studio](https://aistudio.google.com/)\n- Sign in with your Google account\n- Generate a free API key\n- Save the key for later use\n\n### **3. Create a Python Virtual Environment**\n\nSetting up a virtual environment ensures dependencies don’t interfere with system packages.\n\n```bash\npy -m venv env  # Create virtual environment\n```\n\nActivate the environment:\n\n- **Windows:**\n  ```bash\n  env\\Scripts\\activate\n  ```\n- **Mac/Linux:**\n  ```bash\n  source env/bin/activate\n  ```\n\n### **4. Install Required Dependencies**\n\nOnce the virtual environment is activated, install the dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n### **5. Set Up Your API Key**\n\nTo securely store your API key, create a `.env` file in the project directory and add:\n\n```plaintext\nAPI_KEY=your_gemini_api_key_here\n```\n\n---\n\n## **Usage**\n\n### **Text-Based Chat Assistant**\n\nRun the following command to interact with the text-based AI assistant:\n\n```bash\npy text_gemini.py\n```\n\n### **Voice-Based AI Assistant**\n\nRun this command to use the voice-enabled assistant:\n\n```bash\npy voice_gemini.py\n```\n\n---\n\n## **Project Structure**\n\n```\n📂 alexa-clone\n├── 📂 env/                 # Virtual environment (ignored in .gitignore)\n├── 📂 library/             # Helper modules\n├── 📜 text_gemini.py       # Text-based AI assistant\n├── 📜 voice_gemini.py      # Voice-based AI assistant (final outcome)\n├── 📜 requirements.txt     # Required dependencies\n├── 📜 .env                 # API key storage (not committed to Git)\n└── 📜 README.md            # Documentation\n```\n\n---\n\n## **Troubleshooting**\n\n### **Common Issues and Fixes**\n\n#### ❌ `Running Scripts is disabled on this machine`\n\n```bash\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\n```\n\n#### ❌ `ModuleNotFoundError: No module named 'xyz'`\n\n✅ Ensure you've installed all dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n#### ❌ `ImportError: attempted relative import with no known parent package`\n\n✅ Try running the script as a module:\n\n```bash\npy -m text_gemini\n```\n\n#### ❌ API not responding\n\n✅ Verify your `.env` file contains the correct API key.  \n✅ Ensure your internet connection is working.\n\n---\n\n## **Features**\n\n✅ Text-based AI chat assistant  \n✅ Voice-based AI assistant  \n✅ Uses Google's **Gemini API** for responses  \n✅ Lightweight and easy to set up  \n✅ Python-based with minimal dependencies\n\n---\n\n## **Acknowledgments**\n\n🔹 Powered by **Google Gemini AI**  \n🔹 Inspired by **Alexa Voice Assistant**\n🔹 Project by **Google Developer Groups On Campus SSTC**\n\n---\n\nHappy Coding! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeintrovert%2Fgdg-apl-one","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodeintrovert%2Fgdg-apl-one","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodeintrovert%2Fgdg-apl-one/lists"}