{"id":13995788,"url":"https://github.com/maximedegreve/TinyFaces","last_synced_at":"2025-07-22T22:32:32.578Z","repository":{"id":47037133,"uuid":"77459974","full_name":"maximedegreve/TinyFaces","owner":"maximedegreve","description":"Free stock avatars for everyone  👦🏼👨🏾👩🏻  (Built w/ Swift)","archived":false,"fork":false,"pushed_at":"2024-02-08T11:47:30.000Z","size":535,"stargazers_count":541,"open_issues_count":0,"forks_count":14,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-10T14:21:17.788Z","etag":null,"topics":["api","swift","ubuntu","vapor","xcode"],"latest_commit_sha":null,"homepage":"https://tinyfac.es","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maximedegreve.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-12-27T14:08:12.000Z","updated_at":"2024-06-27T13:01:38.000Z","dependencies_parsed_at":"2023-11-23T15:37:47.351Z","dependency_job_id":null,"html_url":"https://github.com/maximedegreve/TinyFaces","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximedegreve%2FTinyFaces","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximedegreve%2FTinyFaces/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximedegreve%2FTinyFaces/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maximedegreve%2FTinyFaces/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maximedegreve","download_url":"https://codeload.github.com/maximedegreve/TinyFaces/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227190374,"owners_count":17745252,"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":["api","swift","ubuntu","vapor","xcode"],"created_at":"2024-08-09T14:03:35.156Z","updated_at":"2024-11-29T18:31:01.193Z","avatar_url":"https://github.com/maximedegreve.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"# TinyFaces 👦🏼👨🏾👩🏻\n\n\u003cimg src=\"/Public/images/github-header.png?raw=true\" width=\"888\"\u003e\n\nTiny Faces is a free crowd-sourced avatar gallery to use in your personal or commercial projects\n\nAlso check out our [Figma Plugin](https://github.com/maximedegreve/TinyFaces-Figma-Plugin) and [Sketch Plugin](https://github.com/maximedegreve/TinyFaces-Sketch-Plugin)\n\n## 🦾 API\n\n**Endpoints**\n\n- `GET`: https://tinyfac.es/api/data?limit=50\u0026gender=female\u0026quality=0\n- `GET`: https://tinyfac.es/api/avatar.jpg?gender=female\u0026quality=0\n\n**Query**\n\n- `quality` : Filters the result(s) to lower or higher quality images by using a value from 0 to 10.\n- `gender` : Possible values for gender can be found in [Gender.swift](/Sources/App/Models/Gender.swift)\n- `limit` : To limit how many results you get back by using a value of 50 or lower. Only works with the data endpoint. When mixed with gender this could return less than n results.\n\n**Limitations**\n\n- Max requests per hour per IP address: `60`\n- When you've reached your limit you'll receive an error response with status code `493`\n\n## 🎒 Before building (dependencies)\n\n- Install [Xcode](https://developer.apple.com/xcode/)\n- Install [Vapor Toolbox](https://docs.vapor.codes/4.0/install/macos/)\n- Install [Docker Desktop](https://www.docker.com)\n- Run `docker-compose up db` or `./Launch.sh`\n- Run `Package.swift` using Xcode\n- Change your Xcode working directory to your root folder: `Schemes \u003e TinyFaces \u003e Edit Scheme \u003e Run \u003e Options \u003e Working Directory \u003e [x]`\n- Add a `.env` file to the local root directory this should have the values below:\n\n```\nSTRIPE_SECRET_KEY=\nSTRIPE_PUBLISH_KEY=\nSTRIPE_PRICE=\nSTRIPE_WEBHOOK_SECRET=\nCLOUDFLARE_ACCOUNT_IDENTIFIER=\nCLOUDFLARE_ACCOUNT_HASH=\nCLOUDFLARE_IMAGES_KEY=\nCLOUDFLARE_BEARER_TOKEN=\nURL=https://tinyfaces.ngrok.io\n```\n\nSadly we can't share our Thumbor setup and therefore you need to run a instance yourself for this to work.\n\n## 🚧 Building\n\n- Run the `Run` target in Xcode\n- The first time this can take a long time because it will seed the database with random first names and last names.\n- The application should now be running on [http://localhost:8080](http://localhost:8080)\n\nIf you want to test Stripe webhooks you set the run a ngrok proxy and make sure you set the correct `STRIPE_SECRET_KEY`, `STRIPE_PUBLISH_KEY`, `STRIPE_WEBHOOK_SECRET` and `STRIPE_PRICINGTABLE_ID` in `.env`\n\n`ngrok http -subdomain=tinyfaces 8080 \u003e /dev/null \u0026`\n\n## 💟 Heroku:\n\n1.  In the project directory: `heroku create --buildpack vapor/vapor`\n2.  Deploy using `git push heroku master` or setup continues deployment in Heroku.\n3.  For logs use command `heroku logs`\n4.  Make sure you fill in all Config Vars on Heroku, see the snippet below:\n\n```\nURL = https://tinyfac.es\nMYSQL_URL =\nPORT =\nTHUMBOR_URL=URL\nTHUMBOR_KEY=ABCDEFG\nSTRIPE_SECRET_KEY=\nSTRIPE_PUBLISH_KEY=\nSTRIPE_PRICINGTABLE_ID=\nSWIFT_BUILD_CONFIGURATION = release\n```\n\n## 📖 Documentation\n\nVisit the Vapor web framework's [documentation](http://docs.vapor.codes) for instructions on how to use this package.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaximedegreve%2FTinyFaces","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaximedegreve%2FTinyFaces","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaximedegreve%2FTinyFaces/lists"}