{"id":19562459,"url":"https://github.com/afri-bit/alpacai","last_synced_at":"2026-02-09T08:32:35.254Z","repository":{"id":226080811,"uuid":"766280293","full_name":"afri-bit/AlpacAI","owner":"afri-bit","description":"Driving Assistant System to avoid driver drowsiness powered by generative AI","archived":false,"fork":false,"pushed_at":"2025-01-30T22:45:35.000Z","size":165163,"stargazers_count":2,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-04-04T18:47:30.675Z","etag":null,"topics":["adas","ai","autonomous-driving","driving-assistant","genai"],"latest_commit_sha":null,"homepage":"","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/afri-bit.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-03-02T20:29:52.000Z","updated_at":"2025-01-30T22:45:12.000Z","dependencies_parsed_at":"2024-08-22T21:23:25.211Z","dependency_job_id":null,"html_url":"https://github.com/afri-bit/AlpacAI","commit_stats":null,"previous_names":["afri-bit/alpacai"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afri-bit%2FAlpacAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afri-bit%2FAlpacAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afri-bit%2FAlpacAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/afri-bit%2FAlpacAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/afri-bit","download_url":"https://codeload.github.com/afri-bit/AlpacAI/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251072279,"owners_count":21532004,"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":["adas","ai","autonomous-driving","driving-assistant","genai"],"created_at":"2024-11-11T05:14:40.985Z","updated_at":"2026-02-09T08:32:35.228Z","avatar_url":"https://github.com/afri-bit.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AlpacAI\n\n\u003cp align=center\u003e\n\u003cimg src=\"https://github.com/zennur/ConversationalAI_SDV/assets/7806017/abd3d0f3-c75c-47e3-ab3c-1b06aa6f8a7d\" width=\"50%\" style=\"border-radius:8%\"/\u003e\n\u003c/p\u003e\n\n## Table of Content\n\n- [AlpacAI](#alpacai)\n  - [Table of Content](#table-of-content)\n  - [Problem Statement](#problem-statement)\n  - [Vision](#vision)\n  - [Future Directions](#future-directions)\n  - [Conceptual System Architecture](#conceptual-system-architecture)\n  - [Prerequistes](#prerequistes)\n    - [General](#general)\n    - [Development](#development)\n  - [Installation](#installation)\n    - [Environment](#environment)\n    - [Application](#application)\n  - [Usage](#usage)\n  - [License](#license)\n\n## Problem Statement\n\nAlpacAI represents a cutting-edge integration of AI technologies with automotive safety systems, designed to redefine the driving experience. At its core, AlpacAI leverages advanced machine learning algorithms, natural language processing, and computer vision to monitor driver attentiveness and provide interactive assistance. By ensuring that drivers remain focused and alert, AlpacAI aims to significantly reduce the risk of accidents caused by distractions.\n\n## Vision\n\nAlpacAI aims to gamify driver experience and ensure road safety by embedding intelligence and attentiveness into every journey. By combining AI's predictive capabilities with real-time monitoring and intervention, AlpacAI not only makes driving safer but also more enjoyable and engaging. It represents a significant step forward in our journey towards fully autonomous vehicles, offering a glimpse into the future of intelligent transportation systems.\n\n## Future Directions\nThe project envisions expanding its capabilities to include predictive accident avoidance, integration with smart city infrastructure for optimized routing, and enhanced personalization features that adapt to each driver's unique preferences and driving patterns. AlpacAI is not just a project; it's a commitment to safer, smarter, and more connected driving experiences.\n\n## Conceptual System Architecture\n\n\u003cp align=center\u003e\n\u003cimg src=\"docs/_assets/img/architecture.png\" width=\"90%\"/\u003e\n\u003c/p\u003e\n\n\n\n## Prerequistes\n\n### General\n* Linux Ubuntu 22.04\n* `python` \u003e 3.10+\n* `gcloud` (See [gcloud installation](https://cloud.google.com/sdk/docs/install?hl=de#deb).)\n* `portaudio`  \n  ```commandline\n  sudo apt install portaudio19-dev python3-all-dev\n  ```\n\n### Development\n\n* Docker (Desktop)\n* Your favourite IDE\n* Your motivation :smiley:\n\n## Installation\n\nFirst thing to do is to clone our repository\n\n```shell\n# Clone the repository\ngit clone https://github.com/afri-bit/AlpacaAI.git\n\ncd AlpacAI\n\n```\n\n### Environment\n\nWithin this project we are providing you a isolated environment using Docker containerization technology. Make sure you have your Docker installed on your local machine, and follow the instruction below.\n\n```shell\n# Assuming you are already inside the project root folder\n\ncd docker\n\n# Building the docker image, in case you haven't\ndocker compose build\n\n# Run the container\ndocker compose run alpacai\n```\n\n### Application\n\n```shell\n# !!! Assuming you are inside the docker container and have the project folder mounted inside the container !!!\n\n# Setup the python virtual environment\npython -m venv .venv\n\n# Activate the virtual environment\nsource .venv/bin/activate\n\n# Install the requirements\n(.venv) pip install -r requirements.txt\n\n# Install python package\n(.venv) pip install .\n```\n\n## Usage\n\n```shell\n# Available commands\nconvagent --help\n  usage: AttentiveAI [-h] [-vip VEHICLE_IP] [-vp VEHICLE_PORT] [-s] [-cp CONFIG_PATH]\n  \n  Intelligent driver drowsiness avoidance with GenAI\n  \n  options:\n    -h, --help            show this help message and exit\n    -vip VEHICLE_IP, --vehicle_ip VEHICLE_IP\n                          IP address to the vehicle interface communication\n    -vp VEHICLE_PORT, --vehicle_port VEHICLE_PORT\n                          Port communication to the vehicle\n    -s, --simulation      Simulation Mode ON\n    -cp CONFIG_PATH, --config_path CONFIG_PATH\n                          Path to JSON file\n\n# Subscribe to KuksaVal and activate Conversation Agent to assist the driver\nconvagent -vip \u003cIP_addr\u003e -vp \u003cPort\u003e\n\n# Run simulation from sample JSON\nconvagent -s\n```\n\n## License\n\nAlpacAI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafri-bit%2Falpacai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fafri-bit%2Falpacai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fafri-bit%2Falpacai/lists"}