{"id":15366383,"url":"https://github.com/talento90/imgart","last_synced_at":"2025-08-02T12:07:02.641Z","repository":{"id":64304896,"uuid":"111200632","full_name":"Talento90/imgart","owner":"Talento90","description":":art: IMGART it's a simple, fast and reliable HTTP service for image processing based on filters and profiles","archived":false,"fork":false,"pushed_at":"2022-10-12T15:44:15.000Z","size":39979,"stargazers_count":63,"open_issues_count":0,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-15T12:25:13.626Z","etag":null,"topics":["golang","http-server","image-processing"],"latest_commit_sha":null,"homepage":"https://imgart.herokuapp.com","language":"Go","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/Talento90.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}},"created_at":"2017-11-18T11:37:50.000Z","updated_at":"2024-04-27T16:16:13.000Z","dependencies_parsed_at":"2023-01-15T10:15:37.787Z","dependency_job_id":null,"html_url":"https://github.com/Talento90/imgart","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Talento90/imgart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talento90%2Fimgart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talento90%2Fimgart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talento90%2Fimgart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talento90%2Fimgart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Talento90","download_url":"https://codeload.github.com/Talento90/imgart/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Talento90%2Fimgart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268385734,"owners_count":24242101,"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-08-02T02:00:12.353Z","response_time":74,"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":["golang","http-server","image-processing"],"created_at":"2024-10-01T13:18:38.596Z","updated_at":"2025-08-02T12:07:02.612Z","avatar_url":"https://github.com/Talento90.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IMGART [![Build Status](https://travis-ci.org/Talento90/imgart.svg?branch=master)](https://travis-ci.org/Talento90/imgart) [![Go Report Card](https://goreportcard.com/badge/github.com/talento90/imgart)](https://goreportcard.com/report/github.com/talento90/imgart)\n\n\n![logo](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"overlay\",\"parameters\":{\"position\":[25,75],\"url\":\"https://goo.gl/UBrXeo\"}},{\"id\":\"overlay\",\"parameters\":{\"position\":[22,-35],\"url\":\"https://goo.gl/aEkkDh\"}}])\n\n\nIMGART it's an HTTP service for image processing based on filters and profiles.\n\nDocumentation: https://imgart.onrender.com/api/v1/docs\n\n### Features\n- Image manipulation\n- Image caching (Redis)\n- Predefined Profiles (MongoDB)\n- API Documentation (Swagger Specification)\n- Error Handling\n- Docker\n- Debugging using Delve and Docker\n- Makefile\n- Testing\n- Graceful shutdown\n- Healthcheck\n\n### Docker Support\n- Dockerfile (Development)\n- Dockerfile.CI (Production)\n- docker-compose.yml (Run application)\n- docker-compose.debug.yml (Run application with delve for debugging)\n\n\n### Setup Project\n- Clone repository: `git clone git@github.com:Talento90/imgart.git`\n- Install dependencies: `make deps`\n- Run using docker: `docker-compose up` or `make docker`\n- Open application: `open http:localhost:4005`\n\n## Usage\n\n`{host}/api/v1/images?imgSrc={0}\u0026profile={1}\u0026filters={2}`\n\n* *host*: Server address\n* *imgSrc*: Image URL\n* *profile*: Profile we want to apply\n* *filters*: List of filters to process\n\n**Example**\n\n```https://imgart.onrender.com/api/v1/images?imgSrc=https://goo.gl/mq7yPD\u0026profile=example\u0026filters=[{\"id\":\"rotate\",\"parameters\":{\"angle\":-90}}]```\n\n**Result**\n\n![result](https://imgart.onrender.com/api/v1/images?imgSrc=https://goo.gl/mq7yPD\u0026profile=example\u0026filters=[{\"id\":\"rotate\",\"parameters\":{\"angle\":-90}}])\n\n\n## Effects\n\nThe engine behind image manipulation is the fabulous library: github.com/disintegration/\n\n\n**Available Effects**\n\n| Effect     | JSON                                                                                             | Result                                                                                                                                                                                                                                                                                                                                                 |\n| ---------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| overlay    | `{\"id\":\"overlay\",\"parameters\":{\"position\":[25,75],\"url\":\"https://goo.gl/UBrXeo\",\"opacity\":100}}` | ![overlay](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=%5B%7B%22id%22:%22overlay%22,%22parameters%22:%7B%22position%22:%5B25,75%5D,%22url%22:%22https://raw.githubusercontent.com/Talento90/imgart/master/assets/mustache.png%22,%22opacity%22:100%7D%7D%5D) |\n| resize     | `{\"id\":\"resize\",\"parameters\":{\"width\":25,\"height\":50,\"filter\":\"linear\"}}`                        | ![resize](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"resize\",\"parameters\":{\"width\":25,\"height\":50,\"filter\":\"linear\"}}])                                                                                                                             |\n| crop       | `{\"id\":\"crop\",\"parameters\":{\"rectangle\":[0,0,202,150]}}`                                         | ![crop](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"crop\",\"parameters\":{\"rectangle\":[0,0,202,150]}}])                                                                                                                                                |\n| rotate     | `{\"id\":\"rotate\",\"parameters\":{\"angle\":-90,\"bgcolor\":\"transparent\"}}`                             | ![rotate](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"rotate\",\"parameters\":{\"angle\":-90,\"bgcolor\":\"transparent\"}}])                                                                                                                                  |\n| blur       | `{\"id\":\"blur\",\"parameters\":{\"sigma\":0.9}`                                                        | ![blur](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"blur\",\"parameters\":{\"sigma\":0.9}}])                                                                                                                                                              |\n| brightness | `{\"id\":\"brightness\",\"parameters\":{\"percentage\":-50}}`                                            | ![brightness](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"brightness\",\"parameters\":{\"percentage\":-50}}])                                                                                                                                             |\n| contrast   | `{\"id\":\"contrast\",\"parameters\":{\"percentage\":100}}`                                              | ![contrast](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"contrast\",\"parameters\":{\"percentage\":100}}])                                                                                                                                                 |\n| gamma      | `{\"id\":\"gamma\",\"parameters\":{\"gamma\":0.2}}`                                                      | ![gamma](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"gamma\",\"parameters\":{\"gamma\":0.2}}])                                                                                                                                                            |\n\t\t\nIt's possible to combine multiple effects:\n\n```json\n/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"overlay\",\"parameters\":{\"position\":[25,75],\"url\":\"https://goo.gl/UBrXeo\"}},{\"id\":\"overlay\",\"parameters\":{\"position\":[22,-35],\"url\":\"https://goo.gl/aEkkDh\"}}, {\"id\":\"crop\",\"parameters\":{\"rectangle\":[0,0,202,150]}}]\n```\n![result](https://imgart.onrender.com/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png\u0026filters=[{\"id\":\"overlay\",\"parameters\":{\"position\":[25,75],\"url\":\"https://goo.gl/UBrXeo\"}},{\"id\":\"overlay\",\"parameters\":{\"position\":[22,-35],\"url\":\"https://goo.gl/aEkkDh\"}},{\"id\":\"crop\",\"parameters\":{\"rectangle\":[0,0,202,150]}}])\n\n\n## Profiles\n\nIf you don't want to specify filters in URL, you can create a profile with all pre configured filters and then use it in query parameters `\u0026profile={profile-id}`.\n\n\n**Create Profile**\n```json\nPOST /api/v1/profiles\n\n{\n    \"id\": \"my-profile\",\n    \"filters\": [\n        { \"id\": \"brightness\", \"parameters\":{ \"percentage\":0.3}},\n        { \"id\": \"crop\", \"parameters\":{\"rectangle\":[0,0,100,200]}}\n    ]\n}\n```\n\n**Using profile in query parameters**\n\n`GET /api/v1/images?imgSrc={image url}\u0026profile=my-profile`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalento90%2Fimgart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftalento90%2Fimgart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftalento90%2Fimgart/lists"}