{"id":48023880,"url":"https://github.com/devkoriel/teslalarm-kr","last_synced_at":"2026-04-04T13:49:20.939Z","repository":{"id":285174274,"uuid":"946573104","full_name":"devkoriel/teslalarm-kr","owner":"devkoriel","description":"🚀 Teslalarm KR Real-time, AI-powered Tesla news \u0026 price alerts tailored for the Korean market. Stay updated on price changes, new model releases, and more – delivered directly to your Telegram. 🔔 Join us and help revolutionize Tesla news in Korea!","archived":false,"fork":false,"pushed_at":"2026-02-27T16:48:29.000Z","size":456,"stargazers_count":2,"open_issues_count":7,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-27T21:26:38.639Z","etag":null,"topics":["crawler","telegram-bot","tesla"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devkoriel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-11T10:55:39.000Z","updated_at":"2025-04-17T01:11:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"1e06de98-c9fe-47e7-88c1-62a6a485a50f","html_url":"https://github.com/devkoriel/teslalarm-kr","commit_stats":null,"previous_names":["devkoriel/teslalarm-kr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/devkoriel/teslalarm-kr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devkoriel%2Fteslalarm-kr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devkoriel%2Fteslalarm-kr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devkoriel%2Fteslalarm-kr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devkoriel%2Fteslalarm-kr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devkoriel","download_url":"https://codeload.github.com/devkoriel/teslalarm-kr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devkoriel%2Fteslalarm-kr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31402276,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: 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":["crawler","telegram-bot","tesla"],"created_at":"2026-04-04T13:49:20.835Z","updated_at":"2026-04-04T13:49:20.922Z","avatar_url":"https://github.com/devkoriel.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Teslalarm KR\n\n[![codecov](https://codecov.io/gh/devkoriel/teslalarm-kr/graph/badge.svg?token=I08064ZBM8)](https://codecov.io/gh/devkoriel/teslalarm-kr)\n[![CodeQL](https://github.com/devkoriel/teslalarm-kr/actions/workflows/codeql.yml/badge.svg)](https://github.com/devkoriel/teslalarm-kr/actions/workflows/codeql.yml)\n[![Renovate](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://renovatebot.com/)\n[![Latest Release](https://img.shields.io/github/release/devkoriel/teslalarm-kr.svg)](https://github.com/devkoriel/teslalarm-kr/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python Version](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/)\n\n**Teslalarm KR** is an open–source real–time alert system for Tesla news. It scrapes Tesla–related articles from various reputable sources, analyzes news events with state–of–the–art natural language processing techniques, and sends notifications via Telegram.\n\n## Features\n\n-   **News Scraping:** Collects Tesla news from multiple sources including domestic and international outlets.\n-   **Event Detection \u0026 Classification:** Uses advanced NLP methods to extract key event details such as vehicle price changes, new model launches, technology updates, and more.\n-   **De–duplication:** Prevents duplicate alerts using Redis.\n-   **Real–time Alerts:** Sends individual notifications through Telegram channels.\n-   **User Subscription \u0026 Settings:** Allows users to set preferred languages and keywords.\n\n## Architecture\n\n-   **Scrapers:** Custom Python scrapers to collect news articles.\n-   **Analyzers:** An NLP module (using OpenAI API and tiktoken) to process and classify news.\n-   **Database:** PostgreSQL for storing articles, events, and user settings.\n-   **Caching:** Redis is used to avoid duplicate notifications.\n-   **Telegram Bot:** Built with python-telegram-bot to send real–time messages.\n-   **Deployment:** Uses Docker Compose for local development and Fly.io for production deployment.\n\n## Installation\n\n1. **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/devkoriel/teslalarm-kr.git\n    cd teslalarm-kr\n    ```\n\n2. **Install dependencies using Poetry:**\n\n    ```bash\n    poetry install\n    ```\n\n3. **Set up Environment Variables:**\n   Create a `.env` file (see below) with the following keys:\n\n    - `OPENAI_API_KEY`\n    - `TELEGRAM_BOT_TOKEN`\n    - `TELEGRAM_CHAT_ID`\n    - `SCRAPE_INTERVAL` (in seconds, default: 300)\n    - `DATABASE_URL` (e.g. `postgresql://user:pass@host:port/dbname`)\n    - `REDIS_URL` (e.g. `redis://host:port`)\n    - `LOG_LEVEL` (e.g. `debug`)\n\n4. **Run the application locally:**\n\n    ```bash\n    poetry run python run.py\n    ```\n\n5. **Deployment:**\n   Use the provided `docker-compose.yml` for local containerization or deploy using Fly.io via the provided GitHub Actions workflow.\n\n## Environment Variables Example (`.env`)\n\n```ini\nTELEGRAM_BOT_TOKEN=your-telegram-bot-token\nTELEGRAM_CHAT_ID=your-telegram-chat-id\nOPENAI_API_KEY=your-openai-api-key\nSCRAPE_INTERVAL=300\nDATABASE_URL=postgresql://myuser:mypassword@db:5432/test_database\nREDIS_URL=redis://redis:6379\nLOG_LEVEL=debug\n```\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for more details and guidelines.\n\n## Code of Conduct\n\nThis project adheres to the [Contributor Covenant Code of Conduct](./CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.\n\n## Contact\n\nFor questions or suggestions, please open an issue or contact one of the maintainers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkoriel%2Fteslalarm-kr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevkoriel%2Fteslalarm-kr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevkoriel%2Fteslalarm-kr/lists"}