{"id":28725854,"url":"https://github.com/cooksleep/time-awareness-filter-for-open-webui","last_synced_at":"2025-06-15T12:08:24.621Z","repository":{"id":298774085,"uuid":"1001094727","full_name":"CookSleep/Time-Awareness-Filter-for-Open-WebUI","owner":"CookSleep","description":"This is a powerful Filter designed for Open WebUI to inject precise temporal context into your conversations. It automatically adds timestamps to both historical and current messages, enabling the Large Language Model to understand the timeline of your dialogue and provide more accurate, context-aware responses.","archived":false,"fork":false,"pushed_at":"2025-06-12T21:49:56.000Z","size":23,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-12T21:52:32.445Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/CookSleep.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,"zenodo":null}},"created_at":"2025-06-12T20:13:52.000Z","updated_at":"2025-06-12T21:49:59.000Z","dependencies_parsed_at":"2025-06-12T21:52:36.281Z","dependency_job_id":"04784f1f-35f7-464a-b341-5026df3196f3","html_url":"https://github.com/CookSleep/Time-Awareness-Filter-for-Open-WebUI","commit_stats":null,"previous_names":["cooksleep/time-awareness-filter-for-open-webui"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CookSleep/Time-Awareness-Filter-for-Open-WebUI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CookSleep%2FTime-Awareness-Filter-for-Open-WebUI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CookSleep%2FTime-Awareness-Filter-for-Open-WebUI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CookSleep%2FTime-Awareness-Filter-for-Open-WebUI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CookSleep%2FTime-Awareness-Filter-for-Open-WebUI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CookSleep","download_url":"https://codeload.github.com/CookSleep/Time-Awareness-Filter-for-Open-WebUI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CookSleep%2FTime-Awareness-Filter-for-Open-WebUI/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259971391,"owners_count":22940013,"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-06-15T12:08:24.116Z","updated_at":"2025-06-15T12:08:24.607Z","avatar_url":"https://github.com/CookSleep.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"right\"\u003e\n\u003ca href=\"./README_zh-CN.md\"\u003e简体中文 🇨🇳\u003c/a\u003e\n\u003c/div\u003e\n\n# ⌛ Time Awareness Filter for Open WebUI\n\nThis is a powerful Filter designed for [Open WebUI](https://github.com/open-webui/open-webui) to inject precise temporal context into your conversations. It automatically adds timestamps to both historical and current messages, enabling the Large Language Model to understand the timeline of your dialogue and provide more accurate, context-aware responses.\n\n[![Author](https://img.shields.io/badge/Author-CookSleep-blue.svg)](https://github.com/CookSleep)\n[![Version](https://img.shields.io/badge/Version-1.1-brightgreen.svg)]()\n[![Compatibility](https://img.shields.io/badge/Open_WebUI-%3E%3D0.6.10-orange.svg)]()\n\n## ✨ Key Features\n\n- **Fully Automatic Time Injection**: Automatically prepends timestamps to all user messages.\n- **Zero-Config Auth \u0026 Timezone**: Automatically detects the current user's authentication info and timezone, eliminating any manual setup for true multi-user support out of the box.\n- **Smart Formatting**:\n  - Displays the full date (`[YYYY-MM-DD, Weekday, HH:MM:SS]`) at the start of a new day.\n  - Uses a concise time format (`[HH:MM:SS]`) for subsequent messages within the same day to enhance readability.\n- **Robust Compatibility**:\n  - Supports plain text, text with images, and file-only messages.\n- **Resilient Error Handling**: Gracefully skips injection if it fails to fetch chat history, ensuring your conversation is not interrupted.\n- **Real-time Toggle**: Easily enable or disable the filter on-the-fly from the Open WebUI interface.\n\n## ⚙️ Configuration\n\nAfter [importing](https://openwebui.com/f/cooksleep/time_awareness) and enabling the Filter (You also need to click \"More\" and enable \"Global\" so that it appears in all conversations), click the gear icon to the right of \"Time Awareness\" under **Admin Panel \u003e Functions** to find the following options:\n\n-   **`api_base_url`**:\n    -   **Description**: The base URL of your Open WebUI backend.\n    -   **Default**: `http://127.0.0.1:8080`\n\n-   **`date_format`**:\n    -   **Description**: The display format for the date.\n    -   **Default**: `ISO`\n    -   **Options**:\n        -   `\"ISO\"` (2025-06-13)\n        -   `\"DMY_SLASH\"` (13/06/2025)\n        -   `\"MDY_SLASH\"` (06/13/2025)\n        -   `\"DMY_DOT\"` (13.06.2025)\n\n-   **`debug_print_request`**:\n    -   **Description**: Logs detailed debugging information to the **Open WebUI backend logs**, useful for troubleshooting.\n    -   **Default**: `False`\n\n## ⚠️ Important Notes\n\n-   This filter requires the `httpx` library. If you have a manual (non-Docker) installation of Open WebUI, ensure it's installed: `pip install httpx`. Docker users don't need to worry, as it's included in the image.\n-   Please ensure the `api_base_url` is configured correctly so the Filter can reach the Open WebUI API.\n\n## 💬 Feedback \u0026 Contributing\n\nIf you encounter any issues or have suggestions for improvement, please feel free to [open an issue](https://github.com/CookSleep/Time-Awareness-Filter-for-Open-WebUI/issues) on GitHub.\n\n## 📜 License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcooksleep%2Ftime-awareness-filter-for-open-webui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcooksleep%2Ftime-awareness-filter-for-open-webui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcooksleep%2Ftime-awareness-filter-for-open-webui/lists"}