{"id":18838819,"url":"https://github.com/starkdmi/avatarstickersserver","last_synced_at":"2026-04-24T23:32:16.465Z","repository":{"id":148564593,"uuid":"453427884","full_name":"starkdmi/AvatarStickersServer","owner":"starkdmi","description":"Server for Avatar Stickers iOS Application ","archived":false,"fork":false,"pushed_at":"2022-01-30T22:00:47.000Z","size":6889,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-26T16:50:26.265Z","etag":null,"topics":["avatar","heroku","lottie","python","server","stickers","telegram","whatsapp"],"latest_commit_sha":null,"homepage":"https://avatarstickers.app","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/starkdmi.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":"2022-01-29T14:54:46.000Z","updated_at":"2023-02-17T12:00:43.000Z","dependencies_parsed_at":"2023-06-26T14:00:39.966Z","dependency_job_id":null,"html_url":"https://github.com/starkdmi/AvatarStickersServer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/starkdmi/AvatarStickersServer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starkdmi%2FAvatarStickersServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starkdmi%2FAvatarStickersServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starkdmi%2FAvatarStickersServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starkdmi%2FAvatarStickersServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/starkdmi","download_url":"https://codeload.github.com/starkdmi/AvatarStickersServer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/starkdmi%2FAvatarStickersServer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32245094,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["avatar","heroku","lottie","python","server","stickers","telegram","whatsapp"],"created_at":"2024-11-08T02:40:50.524Z","updated_at":"2026-04-24T23:32:16.445Z","avatar_url":"https://github.com/starkdmi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## About\nPython Server for [Avatar Stickers](https://apps.apple.com/us/app/avatar-stickers/id1574023061) iOS Application. Server generates animations in [TGS](https://core.telegram.org/animated_stickers) and WebP formats using [Lottie](https://airbnb.io/lottie). Source code of iOS application available [here](https://github.com/starkdmi/AvatarStickers). The application was created while participating in the [contest](https://contest.com/sticker-app). \n\n## Ready to use\nYou can deploy server on Heroku in a minute\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/starkdmi/AvatarStickersServer)\n\nDemo server is available at [facemotion.herokuapp.com](https://facemotion.herokuapp.com). It automatically deployed from **main** branch on changes. \nDemo server isn't used in production and uses free dyno plan. \n\n## Build locally\n### Requirements\n- Python 3.8 (or newer)\n\n### Build\n``` Bash\n# Clone\ngit clone 'https://github.com/starkdmi/AvatarStickersServer'\ncd AvatarStickersServer\n\n# Install requirements\npip install -r requirements.txt\n\n# Run\npython -m uvicorn app:app --host=macpro.home --port=5000 --reload\n```\nUse local network hostname to easily access the server from mobile device while testing.\n\n## Usage\n### Fields\n| Field | Description | Type | Default | Values | Required |\n| --- | --- | --- | --- | --- | --- |\n| service | Messenger name | String | telegram | telegram, whatsapp | YES |\n| emotion | Name of animation | String | | Amazing, Excited, Laugh, Please, Love, Sad, Angry, Crying, Emotionless, Smile, Wink, Football, Basketball | YES |\n| hair | Hair style or Hat type | String | no_hair | **Hair Styles:** no_hair, big_hair, bob, bun, caesar_side_part, caesar, curly, curvy, dreads, frida, 'rizzle, fro_band, fro, long_not_too_long, mia_wallace, shaggy_mullet, shaggy, shaved_sides, short_curly, short_dreads_1, short_dreads_2, short_flat, short_round, short_waved, sides, straight_1, straight_2, straight_strand \u003c/br\u003e\u003c/br\u003e **Hats:** hat, hijab, turban, winter_hat_1, winter_hat_2, winter_hat_3, winter_hat_4 | NO |\n| eyebrows | Eyebrows type | String | default | closed, cry, default, eye_roll, happy, heart, side, surprised, wink_wacky, wink, x_dizzy, squint | NO |\n| eyes | Eyes type | String | default | '', angry_natural, default_natural, default, flat_natural, frown_natural, up_down, up_down_natural, raised_excited_natural, raised_excited, sad_concerned_natural, sad_concerned, unibrow_natural, angry | NO |\n| mouth | Mouth emotion | String | default | concerned, default, disbelief, eating, grimace, sad, scream_open, serious, smile, tongue, twinkle, vomit | NO |\n| beard | Facial hair style | String | '' | '', beard_light, beard_magestic, beard_medium, moustache_fancy, moustache_magnum | NO |\n| gender | Sex | String | male | male, female | NO |\n| accessory | Accessories type | String | '' | '', eyepatch, kurt, prescription_01, prescription_02, round, sunglasses, wayfarers | NO |\n| clothes | Clothes | String | graphic_shirt | '', blazer_shirt, blazer_sweater, collar_sweater, graphic_shirt, hoodie, overall, shirt_crew_neck, shirt_scoop_neck, shirt_v_neck | NO |\n| shirt_graphic | Draw an icon on clothes. Field **clothes** should be set to **graphic_shirt**. | String | custom_text | '', bat, bear, cumbia, custom_text, deer, diamond, hola, pizza, resist, selena, skull_outline, skull | NO |\n| shirt_text | Text written on clothes. Field **shirt_graphic** should be set to **custom_text**. | String | '' | Some text | NO |\n| clothesColor | Clothes color | String | | HEX String - #FFFFFF | NO |\n| beardColor | Facial hair color | String | | HEX String - #FFFFFF | NO |\n| hairColor | Hair color | String | | HEX String - #FFFFFF | NO |\n| hatColor | Hat color | String | | HEX String - #FFFFFF | NO |\n| skinColor | Skin tone color | String | | HEX String - #FFFFFF | NO |\n| text_color | Text color | String | | HEX String - #FFFFFF | NO |\n\n### Example\n```\ncurl -X POST \\\n      -H 'Accept: application/json' \\\n      -H 'Content-type: application/json' \\\n      -H 'Token: SERVER_TOKEN' \\\n      -d '{\"service\": \"telegram\", \"emotion\": \"Laugh\", \"gender\": \"female\", \"mouth\": \"smile\", \"eyes\": \"happy\", \"eyebrows\": \"default\", \"hair\": \"long_not_too_long\", \"clothes\": \"hoodie\", \"hairColor\": \"#A55727\", \"skinColor\": \"#EDB98A\", \"clothesColor\": \"#E0543A\"}' 'http://macpro.home:5000/avatar' \u003e animation.json\n```\n\n## Licenses • Attribution\n- [python_avatars](https://github.com/ibonn/python_avatars) - MIT\n- [python-lottie](https://gitlab.com/mattbas/python-lottie) - GNU AGPLv3\n- [lottie-web](https://github.com/airbnb/lottie-web) - MIT\n- [twemoji](https://github.com/twitter/twemoj) - MIT\n- [Pacifico](https://fonts.google.com/specimen/Pacifico?query=Pacifico#about) - Open Font License\n- [Faster One](https://fonts.google.com/specimen/Faster+One?query=Faster+One#about) - Open Font License\n- [Gee-me](https://iconscout.com/illustrations/gee-me) - CC 4.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarkdmi%2Favatarstickersserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstarkdmi%2Favatarstickersserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstarkdmi%2Favatarstickersserver/lists"}