{"id":18546110,"url":"https://github.com/huksley/veresk","last_synced_at":"2026-04-18T11:04:18.845Z","repository":{"id":145829277,"uuid":"275867717","full_name":"huksley/veresk","owner":"huksley","description":"Generate and share your favorite fractals. This runs serverless via AWS Lambda.","archived":false,"fork":false,"pushed_at":"2023-02-05T13:47:25.000Z","size":1127,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-06T12:45:17.766Z","etag":null,"topics":["flask","fractals","mathplotlib","python"],"latest_commit_sha":null,"homepage":"https://veresk.ruslan.org/","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/huksley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-06-29T16:20:52.000Z","updated_at":"2023-02-07T11:32:36.000Z","dependencies_parsed_at":null,"dependency_job_id":"80191ae8-3f4f-44ed-a095-44fa10e65452","html_url":"https://github.com/huksley/veresk","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/huksley/veresk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huksley%2Fveresk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huksley%2Fveresk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huksley%2Fveresk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huksley%2Fveresk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huksley","download_url":"https://codeload.github.com/huksley/veresk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huksley%2Fveresk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31966218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"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":["flask","fractals","mathplotlib","python"],"created_at":"2024-11-06T20:23:38.886Z","updated_at":"2026-04-18T11:04:18.829Z","avatar_url":"https://github.com/huksley.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Veresk\n\n## Introduction\n\nThis app gives you ability to create different images of fractals.\n\nWhat is a fractal? It is a picture produced my mathematical expression which have recursive nature with unlimited zooming capabilities.\n\nAs image generation controlled by expression, changing the expression even in the slighest manner will result in a sometimes complete different image.\n\nSee [Wikipedia](https://en.wikipedia.org/wiki/Fractal) page for more introduction.\n\n## Example\n\n![](app/static/preview.png)\n\nThis example is a [Julia set](https://en.wikipedia.org/wiki/Julia_set) generated with base complex number `c = -0.37 + 0.6*i`\n\nJulia set is a subset of well-known [Mandelbrot set](https://en.wikipedia.org/wiki/Mandelbrot_set).\n\n## Requirements\n\nThis app requires MongoDB instance available (running in the docker or in the cloud) by setting MONGO_URI environment variable:\n\n```\nMONGO_URI=mongodb://localhost/test\n```\n\n## Running locally\n\nYou need to have Python 3.7 installed.\n\n```\npip install pipenv\npipenv install\nMONGO_URI=mongodb://localhost/test FLASK_SECRET_KEY=123 GITHUB_OAUTH_CLIENT_ID= GITHUB_OAUTH_CLIENT_SECRET= CACHE_BUCKET= pipenv run python -m app\n```\n\nYour app will be available at http://localhost:8080\n\n## Deploying\n\nThis project uses [chamber CLI](https://github.com/segmentio/chamber), [AWS](https://aws.amazon.com/), [MongoDB Atlas](https://www.mongodb.com/cloud/atlas) and [Serverless framework](https://serverless.com) to deploy to the cloud. This result in a highly available, cost-effective, secure and environment to host and serve hobby projects.\n\n### Configure MongoDB instance\n\nCreate MongoDB instance using cloud service (for example MongoDB atlas).\n\nYou will get URL in the form of:\n\n```\nmongodb+srv://username:password@server.mongodb.net/db\n```\n\n### Create AWS account in the cloud\n\nThe way this app uses AWS services, hosting this app will cost you 0.1$ monthly or less, depending on the traffic. Make sure you are protecting your AWS account as the malicious actions of other parties or mistakes can result in a large bill. Read more [here](https://medium.com/@ruslanfg/wip-introduction-to-aws-665d4e9af0c2) about getting started in AWS.\n\n### Configuring other resources in the cloud\n\nTo run successfully full fledged version of the app, number of parameters needs to be set using AWS Parameter Store as `/veresk/NAME_OF_VARIABLE` key. Encrypt using default key (do not use custom KMS key).\n\n* MONGO_URI - URL to previously configured MongoDB instance\n* FLASK_SECRET_KEY - Private key for your Flask app\n* GITHUB_OAUTH_CLIENT_ID - Credentials for GitHub login (create app in Developer settings)\n* GITHUB_OAUTH_CLIENT_SECRET - Credentials for GitHub login\n* CACHE_BUCKET - Create and give access to S3 bucket to store image cache\n\n### Deploy instance to the cloud\n\nYou need to have NodeJS 11+, python 3.7+, pipenv and NPM installed.\n\n```\nnpm install\npip install pipenv\npipenv install\npipenv run deploy\n```\n\n## Licenses\n\n- See LICENSE.md, with the exception of:\n- `app/plot.py`, `def julia`: (C) Tom Roelandts, https://tomroelandts.com/articles/how-to-compute-colorful-fractals-using-numpy-and-matplotlib\n- `app/static/icon.svg`: fractal by Bohdan Burmich from the Noun Project (see https://thenounproject.com/term/fractal/224056/)\n\n## Links\n\n- https://flask.palletsprojects.com/en/1.1.x/tutorial/layout/\n- https://numpy.org/doc/stable/user/quickstart.html\n- https://stackoverflow.com/questions/50728328/python-how-to-show-matplotlib-in-flask\n- https://github.com/lovasoa/mandelbrot\n- https://tomroelandts.com/articles/how-to-compute-colorful-fractals-using-numpy-and-matplotlib\n- https://www.researchgate.net/publication/242295595_Visualising_Infinity_on_a_Mobile_Device#pf2\n- https://en.wikipedia.org/wiki/Julia_set\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuksley%2Fveresk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuksley%2Fveresk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuksley%2Fveresk/lists"}