{"id":18058270,"url":"https://github.com/arya-io/ai-background-changer","last_synced_at":"2026-05-01T06:33:20.570Z","repository":{"id":259194795,"uuid":"876288600","full_name":"arya-io/AI-Background-Changer","owner":"arya-io","description":"This repository contains the AI Background Changer app, built with Streamlit and the Cloudinary AI API. Users can upload images, customize backgrounds with prompts, and download the transformed results.","archived":false,"fork":false,"pushed_at":"2024-10-23T16:48:37.000Z","size":24223,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-25T04:06:46.252Z","etag":null,"topics":["ai","background-removal","cloudinary","computer-vision","data-science","deep-learning","image-processing","image-transformation","machine-learning","open-source","python","streamlit","web-application"],"latest_commit_sha":null,"homepage":"https://ai-background-changer.streamlit.app/","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/arya-io.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-10-21T18:04:15.000Z","updated_at":"2024-10-23T16:48:41.000Z","dependencies_parsed_at":"2024-10-26T18:19:05.082Z","dependency_job_id":null,"html_url":"https://github.com/arya-io/AI-Background-Changer","commit_stats":null,"previous_names":["arya-io/ai-background-changer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arya-io%2FAI-Background-Changer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arya-io%2FAI-Background-Changer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arya-io%2FAI-Background-Changer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arya-io%2FAI-Background-Changer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arya-io","download_url":"https://codeload.github.com/arya-io/AI-Background-Changer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325701,"owners_count":20920714,"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":["ai","background-removal","cloudinary","computer-vision","data-science","deep-learning","image-processing","image-transformation","machine-learning","open-source","python","streamlit","web-application"],"created_at":"2024-10-31T03:05:54.037Z","updated_at":"2026-05-01T06:33:20.543Z","avatar_url":"https://github.com/arya-io.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI-Background-Changer\n\n## Overview\nThis project uses the Cloudinary AI API to change the background of an uploaded image based on a user-provided prompt. It's built using **Streamlit** for the front-end, and integrates **Cloudinary** for image processing. The user can upload an image, input a prompt, and see a transformed image with an AI-generated background.\n\n## Features\n- Upload images in JPG, JPEG, or PNG format.\n- Enter a text prompt for background transformation (e.g., \"futuristic city at night\").\n- View the transformed image in real-time.\n- Download the transformed image directly from the app.\n\n## How It Works\n1. The user uploads an image.\n2. The user enters a prompt (such as \"forest at sunset\").\n3. The app sends the image and prompt to Cloudinary's AI API.\n4. Cloudinary processes the image and replaces the background based on the prompt.\n5. The user can view and download the transformed image.\n\n## Image Showcase\n\n### Original Image\n\u003cimg src=\"OriginalImage1.jpg\" alt=\"Original Image\" width=\"400\"/\u003e\n\n### Transformed Images\n\u003cdiv style=\"display: flex; justify-content: space-around;\"\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003ch4\u003eTransformed Image 1\u003c/h4\u003e\n        \u003cimg src=\"transformed_image.jpg\" alt=\"Transformed Image 1\" width=\"150\"/\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003ch4\u003eTransformed Image 2\u003c/h4\u003e\n        \u003cimg src=\"transformed_image(1).jpg\" alt=\"Transformed Image 2\" width=\"150\"/\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003ch4\u003eTransformed Image 3\u003c/h4\u003e\n        \u003cimg src=\"transformed_image(2).jpg\" alt=\"Transformed Image 3\" width=\"150\"/\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"text-align: center;\"\u003e\n        \u003ch4\u003eTransformed Image 4\u003c/h4\u003e\n        \u003cimg src=\"transformed_image(3).jpg\" alt=\"Transformed Image 4\" width=\"150\"/\u003e\n    \u003c/div\u003e\n\u003c/div\u003e\n\n## Technologies Used\n- **Python**: Backend logic.\n- **Streamlit**: Frontend for user interaction.\n- **Cloudinary**: API for image transformation.\n- **Pillow (PIL)**: For image manipulation.\n- **Requests**: For handling API calls.\n\n## How to Run Locally\n\n### Prerequisites\n- Python installed on your system.\n- A Cloudinary account (for API credentials).\n\n### Setup Instructions\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/arya-io/AI-Background-Changer.git\n   cd AI-Background-Changer\n\n2. **Install the required dependencies:**\n   ```bash\n   pip install -r requirements.txt\n   \n3. **Set up your Cloudinary credentials:**\n    Copy `config_template.py` to `config.py` and fill in your Cloudinary credentials.\n   ```bash\n   cp config_template.py config.py\n\n## Usage\n1. Run the Streamlit app:\n   ```bash\n   streamlit run app.py\n2. Open your web browser and go to `http://localhost:8501` to access the app.\n3. Upload an image and enter a prompt describing the background you'd like. Click \"Submit\" to transform the image. You can then download the transformed image.\n\n## Contributing\nContributions are welcome! If you have suggestions or improvements, please feel free to:\n- Open an issue to discuss any changes you'd like to see.\n- Submit a pull request with your proposed changes.\n\nPlease make sure to follow the project's coding style and include tests for any new features.\n\n## License\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farya-io%2Fai-background-changer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farya-io%2Fai-background-changer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farya-io%2Fai-background-changer/lists"}