{"id":16317055,"url":"https://github.com/simatwa/ai-imager","last_synced_at":"2025-07-29T10:10:22.895Z","repository":{"id":156739579,"uuid":"626466900","full_name":"Simatwa/ai-imager","owner":"Simatwa","description":"Generate and manipulate image with DALL-E and BingImageCreator","archived":false,"fork":false,"pushed_at":"2023-04-30T10:19:31.000Z","size":2384,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T16:14:00.086Z","etag":null,"topics":["bingimagegenerator","dalle","dalle2","flask-application","image-processing","imagegeneration"],"latest_commit_sha":null,"homepage":"http://dawn-quill-allium.glitch.me/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Simatwa.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":"2023-04-11T14:22:41.000Z","updated_at":"2024-08-12T20:30:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"d7335666-5df1-4eaf-8b98-635ea6778ebc","html_url":"https://github.com/Simatwa/ai-imager","commit_stats":{"total_commits":83,"total_committers":2,"mean_commits":41.5,"dds":"0.012048192771084376","last_synced_commit":"d2feadbd69b13f91dd0a1693e1f9e0f051d4f8f4"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Simatwa/ai-imager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fai-imager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fai-imager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fai-imager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fai-imager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simatwa","download_url":"https://codeload.github.com/Simatwa/ai-imager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simatwa%2Fai-imager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267668801,"owners_count":24124967,"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-07-29T02:00:12.549Z","response_time":2574,"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":["bingimagegenerator","dalle","dalle2","flask-application","image-processing","imagegeneration"],"created_at":"2024-10-10T22:06:29.076Z","updated_at":"2025-07-29T10:10:22.857Z","avatar_url":"https://github.com/Simatwa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eAI-Imager\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg align=\"center\" width='80px' height='auto' src=\"https://github.com/Simatwa/ai-imager/raw/main/contents/static/image/favicon.svg\" alt=\"Logo\"/\u003e\u003cbr\u003e\u003cbr\u003e\n\u003ca href=\"https://github.com/Simatwa/ai-imager\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Github\u0026message=passing\u0026logo=github\u0026color=green\" alt=\"Github\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Simatwa/ai-imager/raw/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=License\u0026message=GNU v3.0\u0026logo=license\u0026color=yellow\" alt=\"License\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg src=\"https://visitor-badge.glitch.me/badge?page_id=Simatwa.ai_imager\u0026left_color=lime\u0026right_color=red\u0026left_text=Visitors\" alt=\"visitors\"\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Development\u0026message=Beta\u0026color=Orange\u0026logo=progress\" alt=\"Progress\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Code Style\u0026message=Black\u0026color=black\u0026logo=Black\" alt=\"Code-style\"/\u003e\u003c/a\u003e\n\u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=Coverage\u0026message=80%\u0026color=green\" alt=\"Coverage\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://wakatime.com/badge/github/Simatwa/ai-imager\"\u003e\u003cimg src=\"https://wakatime.com/badge/github/Simatwa/ai-imager.svg\" alt=\"wakatime\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n![Demo](assets/demo.png)\n\n## Features \n\n- Generate image from prompt\n  - BingImageCreator\n  - DALL-E (2)\n- Edit image with a mask\n- Generate variant of an image\n- User-friendly web interface\n\n## Prerequisites\n\n1. [OPENAI-API-KEY](https://platform.openai.com/account/api-keys)\n2. [Bing cookies](bing.com) - (*optional*)\n3. [Python \u003e=3.7](Python.org)\n\n## Installation and usage\n\n### Installation\n\nIf you have enough permissions you can clone from official repo:\n\n```sh\ngit clone https://github.com/Simatwa/ai-imager.git\ncd ai-imager\nbash install.sh\n```\n\nIf you're viewing this locally, you can install by executing the `install.sh` script.\n \n ```sh\nbash install.sh\n```\n\n### Usage\n\nOnce installed, the site can be fired up as follows:\n\n```sh\nai-imager -k $OPENAI_API_KEY\n```\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n\nFire up efficiently - *recommended*\n\n\u003c/summary\u003e\n\n- Make **KEY** an environment variable\n\n```sh\nexport OPENAI_API_KEY=\u003cYour-OPENAI-API-KEY\u003e\n```\n\n- Fire up the server - `$ ai-imager`\n\n- If yout want to use Bing's model, you have to parse the path to the cookie file during start up introduced by `-cf \u003cpath-to-cookie-file.json`.\n\n- Review [how to get the cookie file.](https://github.com/acheong08/EdgeGPT#getting-authentication-require)\n\n\u003c/details\u003e\n\nBy default,  the server has the following configurations.\n\n\u003ctable align=\"center\"\u003e\n    \u003ctr\u003e\n        \u003cth\u003eArgument\u003c/th\u003e\n        \u003cth\u003eDefault\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003ePort\u003c/td\u003e\n        \u003ctd\u003e8000\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eLogging-level\u003c/td\u003e\n        \u003ctd\u003e20\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eHost\u003c/td\u003e\n        \u003ctd\u003eFalse\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003eDebug\u003c/td\u003e\n        \u003ctd\u003eFalse\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003e\n\nRun `$ ai-imager help` for more info.\n\n\u003c/summary\u003e\n\n```\n\nusage: ai-imager [-h] [-v] [-k KEY] [-kp PATH] [-l 10-50] [-o PATH]\n                 [-cf COOKIE_FILE] [--host] [--thread] [--debug]\n                 [port ...]\n\nManipulate images with OpenAI's model\n\npositional arguments:\n  port                  Port to start the server\n\noptions:\n  -h, --help            show this help message and exit\n  -v, --version         show program's version number and exit\n  -k KEY, --key KEY     OpenAI's API key\n  -kp PATH, --key-path PATH\n                        Path to OpenAI-API-KEY path\n  -l 10-50, --logging-level 10-50\n                        Log level of the app\n  -o PATH, --output PATH\n                        Filepath to log to\n  -cf COOKIE_FILE, --cookie-file COOKIE_FILE\n                        Path to Bing's cookie file\n  --host                Host the site on LAN\n  --thread              Run server in multiple threads\n  --debug               Start as debugging server\n\nThis script has no official relation with OpenAI.\n\n```\n\n\u003c/details\u003e\n\n\u003e **Note** To *developers*, execute the [test.py](test.py) script to run server as you modify the contents.\n\n## ToDo\n\n- [x] Generate with BingImageCreator\n- [ ] Download button \n- [ ] Chat feature\n- [ ] Aunthenticate users\n\n## Acknowledgements\n\n- [x] [LawrenceKimutai](https://github.com/LawrenceKimutai)\n\u003c!--\n### Contributors\n\nThis project exists thanks to all the people who contribute.\n\n\u003ca href=\"https://github.com/Simatwa/ai-imager/graphs/contributors\"\u003e\n\u003cimg src=\"https://contrib.rocks/image?repo=Simatwa/ai-imager\" /\u003e\n\u003c/a\u003e\n--\u003e\n\n## Disclaimer\n\nThis is not an official OpenAI product. This is a personal project and is not affiliated with OpenAI in any way. Don't sue me.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Fai-imager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimatwa%2Fai-imager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimatwa%2Fai-imager/lists"}