{"id":20851621,"url":"https://github.com/ahmedkhalf/circle-evolution","last_synced_at":"2025-04-05T03:10:10.949Z","repository":{"id":44415203,"uuid":"263877492","full_name":"ahmedkhalf/Circle-Evolution","owner":"ahmedkhalf","description":"Evolutionary Art Using Circles in Python","archived":false,"fork":false,"pushed_at":"2023-09-30T20:25:38.000Z","size":505,"stargazers_count":357,"open_issues_count":9,"forks_count":46,"subscribers_count":10,"default_branch":"develop","last_synced_at":"2025-03-29T02:08:28.765Z","etag":null,"topics":["art","circles","evolutionary-algorithms","evolutionary-art","genetic-algorithm"],"latest_commit_sha":null,"homepage":"https://ahmedkhalf.github.io/Circle-Evolution/index.html","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/ahmedkhalf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-05-14T09:55:33.000Z","updated_at":"2025-03-03T23:35:33.000Z","dependencies_parsed_at":"2022-08-26T23:11:27.227Z","dependency_job_id":"b6502f51-41ed-414e-af7d-d044f99ce7ca","html_url":"https://github.com/ahmedkhalf/Circle-Evolution","commit_stats":{"total_commits":67,"total_committers":5,"mean_commits":13.4,"dds":0.5373134328358209,"last_synced_commit":"8a304480b37f3bba0f264d90ce7a703a11c296dc"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedkhalf%2FCircle-Evolution","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedkhalf%2FCircle-Evolution/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedkhalf%2FCircle-Evolution/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmedkhalf%2FCircle-Evolution/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmedkhalf","download_url":"https://codeload.github.com/ahmedkhalf/Circle-Evolution/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280272,"owners_count":20912967,"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":["art","circles","evolutionary-algorithms","evolutionary-art","genetic-algorithm"],"created_at":"2024-11-18T03:14:22.984Z","updated_at":"2025-04-05T03:10:10.927Z","avatar_url":"https://github.com/ahmedkhalf.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n    \u003cbr\u003e\n    \u003cimg src=\"docs/images/logo.png\" width=\"500\"/\u003e\n    \u003cbr\u003e\n\u003cp\u003e\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#\"\u003e\n        \u003cimg alt=\"Contributions - Welcome\" src=\"https://img.shields.io/badge/contributions-welcome-brightgreen\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ahmedkhalf/Circle-Evolution/stargazers\"\u003e\n        \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/ahmedkhalf/Circle-Evolution\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ahmedkhalf/Circle-Evolution/network/members\"\u003e\n        \u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/ahmedkhalf/circle-evolution\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ahmedkhalf/Circle-Evolution/blob/master/LICENSE\"\u003e\n        \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/ahmedkhalf/circle-evolution\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\u003ch3 align=\"center\"\u003e\nEvolutionary Art Using Circles\n\u003c/h3\u003e\n\n# Getting Started\n## Installation\n\nYou can download the latest release using pip.\n```bash\npip install circle-evolution\n```\n\n## Usage\n### Command Line\n\nYou can easily start training an image by calling circle_evolution from your terminal\n\n**Example:**\n```bash\ncircle_evolution \"Mona Lisa 64.jpg\" --size 1 --genes 256 --max-generations 50000\n```\n\n| Parameter         | Description                                                          |\n| ----------------- | -------------------------------------------------------------------- |\n| --size            | Image size {1: (64, 64), 2: (128, 128), 3: (256, 256)}. *Default: 2* |\n| --genes           | Number of circle to fit. *Default: 256*                              |\n| --max-generations | Number of generations to run. *Default: 500,000*                     |\n\n### Python Example Script\n\n```python\nfrom circle_evolution import evolution\nfrom circle_evolution import helpers\nimport numpy as np\nimport cv2\n\ntarget = helpers.load_target_image(\"Mona Lisa 64.jpg\", size=(64, 64))\ne = evolution.Evolution(target, genes=256)\n\ne.evolve(max_generation=50000)\n\nhelpers.show_image(e.specie.phenotype)\n\nnp.savetxt(\"Checkpoint.txt\", e.specie.genotype)\ncv2.imwrite(\"OuputImage.jpg\", e.specie.phenotype)\n```\n# Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n## Contributors\n\nAhmed Khalf\n[ahmedkhalf](http://github.com/ahmedkhalf)\n\nGuilherme de Amorim\n[guimorg](http://github.com/guimorg)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedkhalf%2Fcircle-evolution","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmedkhalf%2Fcircle-evolution","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmedkhalf%2Fcircle-evolution/lists"}