{"id":15159973,"url":"https://github.com/pinger00/prex_project_kitt","last_synced_at":"2025-08-02T12:33:47.029Z","repository":{"id":254635449,"uuid":"847096584","full_name":"pinger00/Prex_Project_KITT","owner":"pinger00","description":"Voicebox PREX (Proyecto Robótico Eléctrico X), inspirado en el famoso KITT de la serie \"Knight Rider\". Se trata de un sistema integrado en un vehículo eléctrico Tesla que permite ejecutar comandos, con una personalidad propia basada en humor y asistencia.  // KITT VOICE BOX FOR TESLA's sceens","archived":false,"fork":false,"pushed_at":"2024-08-25T00:58:30.000Z","size":13455,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-20T06:38:48.432Z","etag":null,"topics":["chatgpt","elevenlabs-api","kitt","openai-api","tesla","tesla-api","teslamotors","tessie"],"latest_commit_sha":null,"homepage":"https://github.com/pinger00/Prex_Project_KITT","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pinger00.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-24T20:52:05.000Z","updated_at":"2024-09-18T02:32:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"2d880a10-b596-444e-8342-7ae2e4ff7ad3","html_url":"https://github.com/pinger00/Prex_Project_KITT","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"d5f9e8eb20f4a039dbc2790f0fbd0e29632474ed"},"previous_names":["pinger00/prex_project_kitt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pinger00/Prex_Project_KITT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinger00%2FPrex_Project_KITT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinger00%2FPrex_Project_KITT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinger00%2FPrex_Project_KITT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinger00%2FPrex_Project_KITT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pinger00","download_url":"https://codeload.github.com/pinger00/Prex_Project_KITT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinger00%2FPrex_Project_KITT/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268389168,"owners_count":24242740,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["chatgpt","elevenlabs-api","kitt","openai-api","tesla","tesla-api","teslamotors","tessie"],"created_at":"2024-09-26T22:03:25.553Z","updated_at":"2025-08-02T12:33:47.005Z","avatar_url":"https://github.com/pinger00.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003cem\u003e# Prex_Project_KITT \u003c/em\u003e\u003c/h1\u003e\n\nEste proyecto representa el sistema PREX (Proyecto Robótico Eléctrico X), inspirado en el famoso KITT de la serie \"Knight Rider\". Se trata de un sistema integrado en un vehículo eléctrico Tesla que permite ejecutar comandos, recibiendo feedback del coche, con una personalidad propia basada en humor y asistencia. Habla a tu coche y este te responderá en un tono similar a KITT, puedes pedirle abrir o cerrar el maletero, ver el nivel de batería, pitar, o abrir o cerrar el coche entre otros comandos y lo hará por tí.\n\nCompatible con MCU2 con la app TeslaDisplay (https://tesladisplay.com/). \n\n![Manual_uso](https://github.com/user-attachments/assets/eec56b5a-fa73-4ca1-b213-e7ebec364629)\n\n##  ADVERTENCIA !!!!\nEste software se ha hecho a base de prueba y error, NO SOY PROGRAMADOR. No me hago responsable de los daños que este software pueda ocasionar. Se hizo en colaboración con varias IA's. Mayormente en ChatGPT, aunque también con ayuda de otros LLM's. \t\n\n## REQUISITOS\nConfigura tu .env. Necesitarás las claves API's de mínimo Elevenlabs (cuenta gratuita), OpenAI (cuenta de pago). Necesitarás un servidor con capacidad para ejecutar código python (puede ser cualquier PC).\n\nADMIN_PASSWORD=your_admin_password\nProtege tu vehículo de usos no autorizados, consigue una contraseña lo más fuerte posible.\n\nTESSIE_API_KEY=your_tessie_api_key              \n Imprescindible para comunicar con el vehiculo.\n#### Me puedes ayudar a pagar la suscripción a Tessie usando este enlace: https://share.tessie.com/nDAlwNM5LKb  Muchísimas grácias.\n\nVIN=your_vehicle_identification_number          \nLo puedes conseguir en la app de Tessie\n\nELEVEN_LABS_API_KEY=your_eleven_labs_api_key    \nRegistrate en una cuenta de pago según tu uso\n\nVOICE_ID=sTgnjW6Su298ryjA5cNd                   \nselecciona la voz desde elevenlabs, por defecto voz Prex\n\nGOOGLE_PLACES_API_KEY=your_google_places_api_key \nRegistrate para tener acceso a google maps, gratis con un uso pequeño.\n\nOPENAI_API_KEY=your_openai_api_key              \nConsigue tu KEY en openai\n\nTIMEZONEDB_API_KEY=your_timezonedb_api_key      \nConsigue tu KEY en timezonedb, es gratis\n\n## Opcionales pero muy recomendables:\nAPI TESSIE - IMPRESCINDIBLE para integración con el coche.\nlink referido: https://share.tessie.com/nDAlwNM5LKb    \n\nTIMEZONEDB \nPara ver la hora local, útil si viajas y hay cambios horarios, la api key se puede conseguir gratis.\n\nGoogle Places API - \nSi se le da poco uso puedes registrate grátis.\n\n##REQUISITOS OPERATIVOS:\nPython 3.8+\nFlask\nopenai\nrequests\npython-dotenv\n\n\n## Instalación\n1. Clona el repositorio en tu máquina local:\n   ```\n   git clone https://github.com/pinger00/Prex_Project_KITT\n   ```\n\n2. Instala las dependencias necesarias:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Crea un archivo `.env` en la raíz del proyecto (usa el archivo `.env.example` como referencia) y agrega tus claves API y variables de entorno.\n\n4. Crea un certificado SSL y colócalo en el directorio correspondiente y asegúrate de configurar el servidor con SSL activado.\n\n## Ejecutar el Proyecto\nPara ejecutar el proyecto en modo desarrollo con soporte HTTPS:\n   ```\n   python app/main.py\n   ```\n\n## Configuración del Certificado SSL\nPara ejecutar la aplicación sobre HTTPS, asegúrate de tener tu certificado (`cert.pem`) y clave privada (`key.pem`) listos. Flask puede manejar HTTPS directamente en desarrollo de la siguiente manera:\n   ```python\n   if __name__ == '__main__':\n       app.run(host='0.0.0.0', port=5000, ssl_context=('cert.pem', 'key.pem'))\n   ```\n![IMG](https://raw.githubusercontent.com/pinger00/Prex_Project_KITT/main/glif-you-as-a-flux-action-figure-yo-60414a0b5f-dh992rf0x0x177of5qmzm6tw.png)\n\n## Comandos\nEl archivo `commands.py` te permitirá agregar nuevos comandos que PREX puede ejecutar. Ya vienen configurados algunos comandos básicos como:\n- \"ver la ubicación del coche\"\n- \"compartir dirección\"\n- \"enviar dirección a navegador\"\n- \"compartir vídeo\"\n- \"ver batería\"\n- \"ver kilómetros restantes\"\n- \"ver hora local\"\n- \"buscar X cercano\"\n- \"buscar restaurante cercano\"\n- \"buscar hotel cercano\"\n- \"buscar punto de recarga cercano\"\n- \"buscar supercharger cercano\"\n- \"iniciar recarga\"\n- \"parar recarga\"\n- \"abrir coche\"\n- \"cerrar coche\"\n- \"abrir puerto de recarga\"\n- \"tocar bocina\"\n- \"pita\"\n- \"abrir maletero\"\n- \"cerrar maletero\"\n- \"destellar luces\"\n- \"ver el tiempo\"\n- \"encender clima\"\n- \"apagar clima\"\n- \"poner temperatura a\"\n\n  No es necesario memorizarlos ya que puedes hablar normalmente y el sistema se encarga de detectar si es o no un comando y llamar al comando adecuado.\n\nPara agregar nuevos comandos, edita el archivo `commands.py`. Puedes personalizar el nombre del coche en `prex_config.py` en la sección contexto. También podrás indicar tu modelo de coche para que sepa donde está. \n\n## Como usarlo en la pantalla MCU de tu Tesla\nPuedes abrirlo con el navegador normalmente, pero el reconocimiento de audio está desactivado. Para evitar esa restricción haremos uso de la app https://tesladisplay.com/.\nActivamos la app siguiendo sus instrucciones. Abriremos la web en el navegador Chrome de tu teléfono y ya podremos hacer uso de la app en la pantalla. \n\n## Seguridad\n1. Asegúrate de que el archivo `.env` no sea accesible desde el servidor. El proyecto está configurado para que no se sirva nunca este archivo.\n2. Recomendamos servir la aplicación solo bajo HTTPS para asegurar la transmisión de datos.\n3. Recuerda configurar un ADMIN_PASSWORD=your_admin_password en .env seguro.\n\n# Disfruta de PREX y no olvides contactar conmigo en X, usuario: iPhoneGamesDev\n\n\n******************************************************************************************\n\u003ch1 align=\"center\"\u003e\u003cem\u003e# Prex_Project_KITT \u003c/em\u003e\u003c/h1\u003e\n\nThis project represents the PREX system (Proyecto Robótico Eléctrico X), inspired by the famous KITT from the \"Knight Rider\" series. It is an integrated system in a Tesla electric vehicle that allows executing commands, receiving feedback from the car, with its own personality based on humor and assistance. Talk to your car and it will respond in a tone similar to KITT, you can ask it to open or close the trunk, check the battery level, honk, or open or close the car among other commands and it will do it for you.\n\nCommands and voice are in spanish, You can translate it if you want. You can use IA ;)\n\nCompatible with MCU2 with the TeslaDisplay app (https://tesladisplay.com/).\n\n![Manual_uso](https://github.com/user-attachments/assets/eec56b5a-fa73-4ca1-b213-e7ebec364629)\n\n## WARNING !!!!\nThis software has been made through trial and error, I AM NOT A PROGRAMMER. I am not responsible for any damage this software may cause. It was made in collaboration with several AIs. Mostly in ChatGPT, but also with the help of other LLMs.\n\n## REQUIREMENTS\nSet up your .env. You will need API keys from at least Elevenlabs (free account), OpenAI (paid account). You will need a server capable of running python code (can be any PC).\n\nADMIN_PASSWORD=your_admin_password\nProtect your vehicle from unauthorized uses, get the strongest password possible.\n\nTESSIE_API_KEY=your_tessie_api_key - Essential for communicating with the vehicle. \n### You can help me pay for the Tessie subscription using this link: https://share.tessie.com/nDAlwNM5LKb Thank you very much.\n\nVIN=your_vehicle_identification_number\nYou can get this in the Tessie app\n\nELEVEN_LABS_API_KEY=your_eleven_labs_api_key\nSign up for a paid account according to your usage, there is free ones too.\n\nVOICE_ID=sTgnjW6Su298ryjA5cNd\nselect the voice from elevenlabs, default voice Prex\n\nGOOGLE_PLACES_API_KEY=your_google_places_api_key\nRegister to have access to google maps, free with small usage.\n\nOPENAI_API_KEY=your_openai_api_key\nGet your KEY at openai\n\nTIMEZONEDB_API_KEY=your_timezonedb_api_key\nGet your KEY at timezonedb, it's free\n\nOptional but highly recommended:\nTESSIE API, referral link: https://share.tessie.com/nDAlwNM5LKb\nESSENTIAL for integration with the car.\n\n\nTIMEZONEDB\nTo check the local time, useful if you travel and there are timezone changes, the api key can be obtained for free.\nGoogle Places API -\nIf it is lightly used you can register for free.\n\n# OPERATIONAL REQUIREMENTS:\nPython 3.8+\nFlask\nopenai\nrequests\npython-dotenv\n\n## Installation\n1. Clone the repository to your local machine:\n   ```\n   git clone https://github.com/pinger00/Prex_Project_KITT\n   ```\n\n2. Install the necessary dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Create a `.env` file at the root of the project (use the `.env.example` file as a reference) and add your API keys and environment variables.\n\n4. If you have an SSL certificate, place it in the appropriate directory and make sure to configure the server with SSL enabled.\n\n## Running the Project\nTo run the project in development mode with HTTPS support:\n   ```\n   python app/main.py\n   ```\n\n## SSL Certificate Configuration\nTo run the application over HTTPS, make sure you have your certificate (`cert.pem`) and private key (`key.pem`) ready. Flask can handle HTTPS directly in development as follows:\n   ```python\n   if __name__ == '__main__':\n       app.run(host='0.0.0.0', port=5000, ssl_context=('cert.pem', 'key.pem'))\n   ```\n\n# Commands\nThe commands.py file will allow you to add new commands that PREX can execute. Some basic commands are already configured such as:\n\n- \"see the location of the car\"\n- \"share address\"\n- \"send address to navigator\"\n- \"share video\"\n- \"check battery\"\n- \"check remaining kilometers\"\n- \"check local time\"\n- \"search for X nearby\"\n- \"search for a nearby restaurant\"\n- \"search for a nearby hotel\"\n- \"search for a nearby charging point\"\n- \"search for a nearby supercharger\"\n- \"start charging\"\n- \"stop charging\"\n- \"open car\"\n- \"close car\"\n- \"open charging port\"\n- \"honk horn\"\n- \"beep\"\n- \"open trunk\"\n- \"close trunk\"\n- \"flash lights\"\n- \"check the weather\"\n- \"turn on climate control\"\n- \"turn off climate control\"\n- \"set temperature to\"\n\nThere is no need to memorize them as you can talk normally and the system will detect whether or not it is a command and call the appropriate command. Right now is configured in spanish, but maybe can work in english too without modify anything.\n\nTo add new commands, edit the commands.py file. You can customize the name of the car in prex_config.py in the context section. You can also indicate your car model and name so it knows where it is, even translate the context to your language.\n\n## How to Use It on Your Tesla's MCU Screen\nYou can open it with the browser normally, but audio recognition is disabled. To bypass this restriction, we will use the app https://tesladisplay.com/.\nActivate the app following its instructions. Open the web in the Chrome browser of your phone and you will be able to use the app on the screen.\n\n\n## Security\n1. Make sure the .env file is not accessible from the server. The project is set up so that this file is never served.\n2. We recommend serving the application under HTTPS only to secure data transmission.\n3. Remember to configure a secure ADMIN_PASSWORD=your_admin_password in .env \n\n# Enjoy PREX and don't forget to connect with me on X, user: iPhoneGamesDev\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinger00%2Fprex_project_kitt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinger00%2Fprex_project_kitt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinger00%2Fprex_project_kitt/lists"}