{"id":14964864,"url":"https://github.com/slashtechno/tldscroll","last_synced_at":"2025-10-07T09:54:32.986Z","repository":{"id":254191447,"uuid":"845760542","full_name":"slashtechno/tldscroll","owner":"slashtechno","description":"A Slack bot that helps you to summarize long messages and threads.  ","archived":false,"fork":false,"pushed_at":"2024-08-25T03:50:17.000Z","size":30691,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T06:23:03.141Z","etag":null,"topics":["ollama","slack"],"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/slashtechno.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-21T22:00:49.000Z","updated_at":"2024-10-21T12:46:30.000Z","dependencies_parsed_at":"2024-08-22T00:13:59.715Z","dependency_job_id":"4e211844-b1a1-4753-a89c-49f9306b7acd","html_url":"https://github.com/slashtechno/tldscroll","commit_stats":{"total_commits":32,"total_committers":1,"mean_commits":32.0,"dds":0.0,"last_synced_commit":"e13ea2abd2b0c1a69f4d109a9ae6c15eba370cf2"},"previous_names":["slashtechno/tldscroll"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/slashtechno/tldscroll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Ftldscroll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Ftldscroll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Ftldscroll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Ftldscroll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slashtechno","download_url":"https://codeload.github.com/slashtechno/tldscroll/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slashtechno%2Ftldscroll/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278755164,"owners_count":26040034,"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-10-07T02:00:06.786Z","response_time":59,"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":["ollama","slack"],"created_at":"2024-09-24T13:33:52.628Z","updated_at":"2025-10-07T09:54:32.973Z","avatar_url":"https://github.com/slashtechno.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Too Long; Didn't Scroll (TL;DS)  \nA Slack bot that helps you to summarize long messages and threads.  \n\n[![Demo](tlds-demo_2024-08-22_19-24-01.gif)](tlds-demo_2024-08-22_19-24-01.mp4)\n\n\n### Features  \n* Summarize messages and threads\n    * Running on a top-level message will summarize the message along with its replies, if any exist  \n    * Running on a reply will summarize the reply  \n* Summarize messages and threads with a single click (well, two clicks)\n    * Use the `Generate Summary` message action to summarize\n* Customizable visibility\n    * When using the `/tlds` command, you can choose whether the summary is visible to everyone or is ephemeral and only visible to you  \n    * When using the `Generate summary` message action, the summary is ephemeral and only visible to you\n    * When using the `Generate public summary` message action, the summary is visible to everyone\n* Customizable LLM model and provider  \n    * Supports [Ollama](https://ollama.com/) for local/on-premises summarization  \n    * Supports OpenAI-compatible APIs for cloud-based summarization\n        * Examples include [OpenAI](https://openai.com/) and [OpenRouter](https://openrouter.ai/)  \n* A help command (`/tlds-help`) to show the available commands and options\n\n\n### Setup   \n1. Create a new Slack app at [api.slack.com/apps](https://api.slack.com/apps)\n2. Use the `manifest.yml` file to create it  \n3. Install the app to your workspace  \n4. Clone the repository  \n\u003c!-- Even though .secrets.toml may be better, .env can easily be loaded by Docker Compose --\u003e\n5. Copy the `example.env` file to `.env` and fill in the values\n    * Alternatively, you can use `.secrets.toml` and `settings.toml`  \n    * For more information, check the `example.*.toml` files  \n\n#### Running the server  \n##### Docker \nRun the following command to build and run the Docker container:  \n```sh\ndocker-compose up\n```  \nIf you want to run the container in the background, use the `-d` flag:  \n```sh\ndocker-compose up -d\n```\nIf you have Ollama running on the host, the host can be accessed by the container by using `host.docker.internal` as the host name. For example, if Ollama is running on port `11434` (the default), setting the `base_url` to `http://host.docker.internal:11434` will allow the container to access Ollama.  \nThe `docker-compose.yml` file also has a commented-out section for Ollama that can be used. However, setting it up on the host or by itself can offer more flexibility. To use the Ollama section in the `docker-compose.yml` file, uncomment the section. The `base_url` should be `http://ollama:11434` in this case.  \n\n##### Poetry  \nIf you want to run the server without Docker, you can use [Poetry](https://python-poetry.org/):    \n```sh\npoetry install\npoetry run python -m tlds\n```\n\n\n### Usage  \n1. Add the app to channel(s) where you want it to be able to summarize messages from   \n2. Use the `/tlds` command or the `Generate Summary`/`Generate public summary` message actions to summarize messages and threads","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslashtechno%2Ftldscroll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslashtechno%2Ftldscroll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslashtechno%2Ftldscroll/lists"}