{"id":26678385,"url":"https://github.com/telexintegrations/daily-summary-generator","last_synced_at":"2025-07-13T11:36:32.540Z","repository":{"id":278746966,"uuid":"936627045","full_name":"telexintegrations/daily-summary-generator","owner":"telexintegrations","description":"The Daily Summary Generator is a Telex integration that automatically compiles and summarizes messages from a Telex channel every 24 hours (or at a configured interval).","archived":false,"fork":false,"pushed_at":"2025-02-21T13:55:14.000Z","size":158,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T05:15:32.371Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/telexintegrations.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-02-21T12:09:11.000Z","updated_at":"2025-02-21T23:39:54.000Z","dependencies_parsed_at":"2025-02-21T13:38:07.891Z","dependency_job_id":"4eca10d1-1c8c-4796-8e40-815233dd835c","html_url":"https://github.com/telexintegrations/daily-summary-generator","commit_stats":null,"previous_names":["telexintegrations/daily-summary-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/telexintegrations/daily-summary-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fdaily-summary-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fdaily-summary-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fdaily-summary-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fdaily-summary-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telexintegrations","download_url":"https://codeload.github.com/telexintegrations/daily-summary-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telexintegrations%2Fdaily-summary-generator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265133793,"owners_count":23716430,"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-03-26T05:15:39.673Z","updated_at":"2025-07-13T11:36:32.502Z","avatar_url":"https://github.com/telexintegrations.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📢 Daily Summary Generator - Telex Integration  \n\nThe **Daily Summary Generator** is a Telex integration that **automatically compiles and summarizes messages** from a Telex channel every 24 hours (or at a configured interval).  \nIt provides **clear, structured reports** of the day's conversations, helping teams track key discussions, issues, and resolutions.\n\n---\n\n## 🚀 Features\n\n### ✅ **Automated Daily Summaries**\n\n- Collects messages from the past 24 hours in a **Telex channel**.\n- Generates a structured summary using **OpenAI's GPT-4 API**.\n- Posts the summary back to Telex via the provided `return_url`.\n\n### ✅ **Smart Categorization**\n\n- Summarizes messages into key sections:\n  - 🐛 **Bugs \u0026 Issues**  \n  - 🚀 **Deployments \u0026 Fixes**  \n  - 🔐 **Security Alerts**  \n  - 🔌 **Infrastructure Issues**  \n\n### ✅ **Supports OpenAI API Key from Settings**\n\n- The integration **retrieves the OpenAI API key** from the settings, ensuring secure and customizable AI usage.\n\n### ✅ **Handles Missing Messages Gracefully**\n\n- If no messages are found, the bot responds with `\"No messages to show.\"`, ensuring users get relevant updates.\n\n### ✅ **Error Handling \u0026 Reporting**\n\n- If an issue occurs (e.g., invalid API key, OpenAI API failure), an **error message is sent to the return URL**.\n\n### ✅ **Flexible Scheduling**\n\n- Users can **configure the summary generation interval** using cron-like syntax (`0 8 * * *` for daily at 8 AM).\n\n---\n\n## 🛠️ Setup \u0026 Configuration  \n\n### **1️⃣ Install Dependencies**\n\n```bash\nnpm install\n```\n\n### **2️⃣ Configure Environment Variables**\n\nCreate a `.env` file with the following keys:\n\n```plaintext\nMONGO_URI=mongodb://localhost:27017/telex_db\n```\n\n### **3️⃣ Start the Server**\n\n```bash\nnpm run dev\n```\n\n---\n\n## 🔧 Configuration Options\n\nThe integration settings allow customization:\n\n| **Setting** | **Description** | **Example Value** |\n|------------|----------------|------------------|\n| `interval` | Cron expression for summary frequency | `\"0 8 * * *\"` (daily at 8 AM) |\n| `openai_api_key` | OpenAI API key for generating summaries | `\"sk-...\"` |\n\n---\n\n## 📸 Screenshots\n\n  ![Simulated Messages in a channel](./assets/daily_summary-texts.png)\n![Daily Summary Bot](./assets/daily_summary_bot.png)\n\n---\n\n## ⚠️ Error Handling\n\n- If OpenAI API fails, an **error message is sent** to the `return_url`.  \n- If the API key is missing or invalid, a **notification is sent** back to Telex.\n\n---\n\n## 🔗 Related Links  \n\n- 📜 [Telex API Docs](https://telex.im/docs)  \n- 🧠 [OpenAI API Docs](https://platform.openai.com/docs)  \n\n---\n\n## 📬 Contact  \n\n👨‍💻 Developed by **Alexin**  \n📧 Email: [alexindevs](mailto://alexindevs@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fdaily-summary-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelexintegrations%2Fdaily-summary-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelexintegrations%2Fdaily-summary-generator/lists"}