{"id":23451037,"url":"https://github.com/a3ro-dev/fam","last_synced_at":"2026-03-03T09:33:10.808Z","repository":{"id":269170781,"uuid":"812615710","full_name":"a3ro-dev/FAM","owner":"a3ro-dev","description":"Fam Assistant is a voice-activated assistant designed to run on devices like the Raspberry Pi. It integrates various functionalities such as music playback, task management, and game launching, providing a comprehensive assistant experience.","archived":false,"fork":false,"pushed_at":"2025-03-26T16:15:11.000Z","size":340991,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T12:51:21.004Z","etag":null,"topics":["ai","ai-assistant","games","gaming-console","home-assistant","js","music","music-player","psp","python","python3","voice-assistant"],"latest_commit_sha":null,"homepage":"https://fam-ai-web.streamlit.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a3ro-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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-06-09T11:56:39.000Z","updated_at":"2025-03-26T16:15:16.000Z","dependencies_parsed_at":"2025-02-15T19:45:17.912Z","dependency_job_id":"1991adc1-ef15-4604-aaa0-e6b05c91e78d","html_url":"https://github.com/a3ro-dev/FAM","commit_stats":null,"previous_names":["a3ro-dev/fam"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/a3ro-dev/FAM","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2FFAM","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2FFAM/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2FFAM/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2FFAM/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a3ro-dev","download_url":"https://codeload.github.com/a3ro-dev/FAM/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a3ro-dev%2FFAM/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30039886,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T06:58:30.252Z","status":"ssl_error","status_checked_at":"2026-03-03T06:58:15.329Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ai","ai-assistant","games","gaming-console","home-assistant","js","music","music-player","psp","python","python3","voice-assistant"],"created_at":"2024-12-24T00:18:04.655Z","updated_at":"2026-03-03T09:33:10.766Z","avatar_url":"https://github.com/a3ro-dev.png","language":"JavaScript","readme":"# FAM Assistant 🚀\r\n\r\n## Table of Contents\r\n- [Features](#features)\r\n- [Technical Details](#technical-details)\r\n- [Setup](#setup)\r\n- [Usage](#usage)\r\n- [Gesture Control](#gesture-control)\r\n- [Project Structure](#project-structure)\r\n- [Development](#development)\r\n- [License](#license)\r\n- [Support](#support)\r\n\r\n## Features\r\n\r\n### Core Functions\r\n- Voice control with GPT integration\r\n- Gesture control using ultrasonic sensor\r\n- Music playback and playlist management \r\n- Task/reminder system\r\n- Game server hosting\r\n- Raspotify (Spotify Connect) control\r\n\r\n### Technical Details\r\n- Multi-threaded architecture for responsive operation\r\n- GPIO-based gesture detection (HC-SR04 sensor)\r\n- Audio playback via pygame\r\n- Local music library with Spotify sync\r\n- HTTP game server with email invites\r\n\r\n## Setup\r\n\r\n1. Clone and install:\r\n```bash\r\ngit clone https://github.com/a3ro-dev/FAM\r\ncd FAM\r\npip install -r requirements.txt\r\n```\r\n\r\n2. Configure `conf/config.yaml`:\r\n```yaml\r\nmain:\r\n    access_key: \"\u003cyour_access_key_here\u003e\"\r\n    keyword_path: \"\u003cyour_keyword_path_here\u003e\"\r\n    music_path: \"\u003cyour_music_path_here\u003e\"\r\n    groq_api_key: \"\u003cyour_groq_api_key_here\u003e\"\r\n    openai_api_key: \"\u003cyour_openai_api_key_here\u003e\"\r\n    model_name: \"\u003cyour_model_name_here\u003e\"\r\nutilities:\r\n    author: \"\u003cyour_name_here\u003e\"\r\n    audio_files:\r\n        success: \"\u003cpath_to_success_audio_file_here\u003e\"\r\n        error: \"\u003cpath_to_error_audio_file_here\u003e\"\r\n        load: \"\u003cpath_to_load_audio_file_here\u003e\"\r\n    model_path: \"\u003cpath_to_model_here\u003e\"\r\n    weather_api_key: \"\u003cyour_weather_api_key_here\u003e\"\r\n    news_api_key: \"\u003cyour_news_api_key_here\u003e\"\r\n    email:\r\n        sender_email: \"\u003cyour_email_here\u003e\"\r\n        sender_password: \"\u003cyour_password_here\u003e\"\r\n        smtp_server: \"\u003cyour_smtp_server_here\u003e\"\r\n        smtp_port: \"\u003cyour_smtp_port_here\u003e\"\r\n    image_path: \"\u003cpath_to_image_here\u003e\"\r\nmusic_search:\r\n    output_path: \"\u003cpath_to_output_here\u003e\"\r\n```\r\n3. Run:\r\n```bash\r\npython main.py\r\n```\r\n\r\n## Usage\r\n\r\n### Voice Commands\r\n\r\n#### System\r\n- \"Shutdown\" - Power off system\r\n- \"Start my day\" - Morning routine\r\n- \"Enable/disable raspotify\" - Control Spotify Connect\r\n\r\n#### Media\r\n- \"Play/pause/resume/stop music\"\r\n- \"Play [song name]\"\r\n- \"Next/skip\" - Next track\r\n- \"Download [song]\" - Add to library\r\n\r\n#### Games\r\n- \"Play/start game\" - Launch game server\r\n- \"Stop/end game\" - Stop server\r\n\r\n#### Tasks\r\n- \"Add task\" - Create new task\r\n- \"Search task\" - Find existing task\r\n\r\n### Gesture Control\r\nHold hand 2-5cm from ultrasonic sensor to activate voice input.\r\n\r\n## Project Structure\r\n```\r\nFamAssistant/\r\n├── \r\n\r\nmain.py\r\n_fam_assistant.py\r\n\r\n                      # Main assistant implementation\r\n├── libs/\r\n│   ├── bluetooth_manager.py     # Bluetooth functionality\r\n│   ├── clock.py                 # Time and task management\r\n│   ├── games.py                 # Games management\r\n│   ├── gpt.py                   # GPT integration\r\n│   ├── music.py                 # Music player implementation\r\n│   ├── raspotify_wrapper.py     # Spotify Connect control\r\n│   ├── music_search.py          # Music search and download\r\n│   └── utilities.py             # Utility functions\r\n├── assets/\r\n│   └── tts_audio_files/         # Text-to-speech audio files\r\n├── conf/\r\n│   ├── config.example.yaml      # Example configuration file\r\n│   └── config.yaml              # User configuration file\r\n├── \r\n\r\nREADME.md\r\n\r\n                    # Project documentation\r\n└── \r\n\r\nrequirements.txt\r\n\r\n             # Python dependencies\r\n```\r\n\r\n---\r\n\r\n## Development\r\n\r\n- Built with Python 3.11.x\r\n- Uses ThreadPoolExecutor for I/O operations\r\n- Implements hardware debouncing for gesture detection\r\n- Comprehensive error handling and logging\r\n\r\n## License\r\n\r\nThis work is licensed under a [Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License](http://creativecommons.org/licenses/by-nc-nd/4.0/).\r\n\r\n---\r\n\r\n## Support\r\n\r\nFor any questions or issues, reach out at [akshatsingh14372@outlook.com](mailto:akshatsingh14372@outlook.com).\r\n\r\nDeveloper: [a3ro-dev](https://github.com/a3ro-dev)\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3ro-dev%2Ffam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa3ro-dev%2Ffam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa3ro-dev%2Ffam/lists"}