{"id":13456077,"url":"https://github.com/Kav-K/Described","last_synced_at":"2025-03-24T09:31:21.852Z","repository":{"id":207096686,"uuid":"718407183","full_name":"Kav-K/Described","owner":"Kav-K","description":"Automatically describe images sent by users on popular media platforms, incredibly useful for the visually impaired and for complicated imagery.","archived":false,"fork":false,"pushed_at":"2023-11-17T08:25:42.000Z","size":21,"stargazers_count":21,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-09T01:26:29.480Z","etag":null,"topics":["asyncio","caption","captions","chatbot","chatgpt","describe-image","discord","gpt","gpt4","help-wanted","learn","multimodal","python"],"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/Kav-K.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}},"created_at":"2023-11-14T02:22:13.000Z","updated_at":"2024-09-27T17:33:54.000Z","dependencies_parsed_at":"2023-11-17T09:54:30.653Z","dependency_job_id":"416b06a8-ad60-452a-8906-c579e203333f","html_url":"https://github.com/Kav-K/Described","commit_stats":null,"previous_names":["kav-k/described"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kav-K%2FDescribed","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kav-K%2FDescribed/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kav-K%2FDescribed/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kav-K%2FDescribed/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kav-K","download_url":"https://codeload.github.com/Kav-K/Described/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245243275,"owners_count":20583597,"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":["asyncio","caption","captions","chatbot","chatgpt","describe-image","discord","gpt","gpt4","help-wanted","learn","multimodal","python"],"created_at":"2024-07-31T08:01:15.857Z","updated_at":"2025-03-24T09:31:21.470Z","avatar_url":"https://github.com/Kav-K.png","language":"Python","readme":"\u003ch1 align=\"center\"\u003eDescribed\u003c/h1\u003e\n\u003cp align=\"center\"\u003eAn open-source system for automatically describing images sent by users on popular media platforms. Currently supports Discord, support for Slack, Messenger, Telegram, other platforms coming soon!\n\n\u003ccenter\u003e\n\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Kav-K/Described/graphs/commit-activity)  \n[![GitHub license](https://img.shields.io/github/license/Kav-K/Described)](https://github.com/Kav-K/Described/blob/main/LICENSE)  \n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\n\u003c/center\u003e\n\n# Overview\nAutomatically describe images sent by users on popular media platforms. Incredibly useful for the visually impaired, Describer will automatically ingest images and using GPT-4-Vision, will interpret the images and convert it into a human-readable textual representation that aims to give users a holistic understanding of the image without needing to be dependent on visually seeing the image itself.\n\n**BOT SETUP SUPPORT AND DEMO SERVER:** [Join Here](https://discord.gg/WvAHXDMS7Q)\n\n# Demo\n![Demo](https://i.imgur.com/NXNb7a6.png)\n\n# Setup\nPython 3.9 and above are supported\n\nTo get up and running with the bot, you need to install the requirements, set up your environment variables, and start the bot.\nTo install the requirements:\n```bash\npython3.9 -m pip install -r requirements.txt\n```\n\nThen, rename `sample.env` to `.env` and fill it in with your corresponding API keys:\n```dotenv\nDISCORD_TOKEN=\"MTE.....\"\nOPENAI_API_KEY=\"sk-.......\"\nDESCRIBED_CHANNELS=\"mute-this-testing,blank-test\"\nALLOWED_GUILDS=\"1061370086331523176\"\nADMIN_ROLES=\"Admin\"\n```\nAllowed guilds are comma separated values of guild IDs. You can retrieve guild IDs by right clicking a server on the top left of your discord window and then clicking \"Copy ID\". Channel names and admin_roles are also case-sensitive and comma separated.\n\nYou can get an OpenAI API Key [here](https://help.openai.com/en/articles/4936850-where-do-i-find-my-api-key), and learn how to create a discord bot [here](https://www.writebots.com/discord-bot-token/)\n\n# Usage\nTo start the bot from the root directory of the repo, run:\n```bash\npython -m discord_service.bot\n```\n\nOnce other platforms are supported, there will be more commands to run the bots for the other platforms. Moreover, an all-in-one command will be created that runs everything.\n\nWithin a discord server only the users that have roles defined in `ADMIN_ROLES` in your environment file are able to turn image descriptions on and off. By default for a server, image descriptions are off. You can turn them on with:\n\n`/describe status:on`\n\nYou can turn them off with\n\n`/describe status:off`\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKav-K%2FDescribed","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FKav-K%2FDescribed","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FKav-K%2FDescribed/lists"}