{"id":17030417,"url":"https://github.com/vsoch/opensource-art","last_synced_at":"2025-08-03T13:08:49.500Z","repository":{"id":45242616,"uuid":"144051522","full_name":"vsoch/opensource-art","owner":"vsoch","description":"open source, collaborative art generation that combines hand and machine","archived":false,"fork":false,"pushed_at":"2024-05-29T17:38:10.000Z","size":52933,"stargazers_count":13,"open_issues_count":6,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T12:12:05.035Z","etag":null,"topics":["art","circle-ci","collaborative","deep-dream","gallery","github-pages","machine-learning","open-source","opensource-art"],"latest_commit_sha":null,"homepage":"https://vsoch.github.io/opensource-art/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vsoch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","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":"2018-08-08T18:15:53.000Z","updated_at":"2025-01-09T16:45:23.000Z","dependencies_parsed_at":"2024-06-11T17:03:18.490Z","dependency_job_id":"2057eb9d-2225-4c43-a867-19760c007e8d","html_url":"https://github.com/vsoch/opensource-art","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/vsoch%2Fopensource-art","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fopensource-art/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fopensource-art/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsoch%2Fopensource-art/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vsoch","download_url":"https://codeload.github.com/vsoch/opensource-art/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248565078,"owners_count":21125417,"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","circle-ci","collaborative","deep-dream","gallery","github-pages","machine-learning","open-source","opensource-art"],"created_at":"2024-10-14T08:06:49.260Z","updated_at":"2025-04-12T12:12:08.514Z","avatar_url":"https://github.com/vsoch.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open Source Art\n\n![docs/assets/logo.jpg](docs/assets/logo.jpg)\n\n[![CircleCI](https://circleci.com/gh/vsoch/opensource-art.svg?style=svg)](https://circleci.com/gh/vsoch/opensource-art)\n\n - [What is OpenSource Art](#what-is-opensource-art): Read here if you want to learn about the gallery generated and housed here.\n - [Contribute your Work](#contribute-your-work): Contributing your work combines down to adding some files to this repository. If you aren't an artist, you can [post an issue](https://www.github.com/vsoch/opensource-art/issues) and we will help you.\n - [Ask a question](https://www.github.com/vsoch/opensource-art/issues): Have a question? Need some help? We are here for you!\n\nOr jump right in and [View the Gallery](https://vsoch.github.io/opensource-art).\n\n## What is Opensource Art?\n\nWhile traditionally used for programming, this reposity combines open source development with community artistic contributions to create the first automated, programatically and manually generated gallery.\n\n### Background\n\nThere is typically a strong distinction between things that are made by hand, and by machine. \nIt's also more likely the case that you see artist work attributed to one or a few individuals - the paintings in your favorite\ngallery are done by one individual, or it's perhaps a collaboration between a small group.\n\nBring in open source. Open source is a powerful framework with under which many eyes can make tiny contributions to develop highly\ncomplex systems. In the context of programming, this means that a group of developers opens up their code base for contributions from\nthe community, and many eyes on the code squash the bugs. \n\n## How does this work?\n\nUnder this same model, many small artistic contributions can create unexpected beauty.\n\n### 1. The Human Component\n\nThe base of the entire gallery, whether it be code that drives its generation or the human hand, starts with a human component. \nHow does this work?\n\n 1. Any member of the community can contribute a texture, a graphic, or digital piece. The contribution is done via a pull request (or contact of one of the Open Source Art maintainers, in the case the artist is not familiar with Github).\n 2. The contribution (if necessary) can be discussed and reviewed.\n 3. The texture is added to the library housed in the repository\n\n### 2. The Digital Gallery\n\nFrom the human component, we have a version controlled collection of community contributions. Each carries with it metadata about the artist and (if one exists) a title and description. Here is where the machine, and concepts from software engineering like version control, continuous integration, and machine learning come into play! We use these technologies to automate the process of generating new works from the existing.\n\n 4. Each day, a set of textures (or derivations from them) are randomly chosen during an automated testing step in a continuous integration service.\n 5. Machine learning is performed via a reproducible container to generate a new work\n 6. The new work is saved, and added programatically back to the gallery.\n\n### 3. The Open Source Art Story\n\nOver time, the gallery grows in size and complexity. We generate a new image each day, and so the earlier pieces become part of the later ones. The earliest contributions start the development of a story, and community members can contribute new textures (or similar) at any frequency to continue developing the story.\n\n# Contribute Your Work\n\nContributing comes down to submission of a [pull request](https://yangsu.github.io/pull-request-tutorial/) (called a PR) to this repository.\nYou can also opt to [fill in an online form](https://vsoch.github.io/opensource-art/contribute) for a manual submission.\n\n### Manual Generation\nFirst, the repository, and clone it to your local computer.\n\n```bash\ngit clone https://www.github.com/\u003cusername\u003e/opensource-art\ncd opensource-art\n```\n\n## Template\n\nNext, copy one of the current works pages under [_works](docs/_works), and give it a unique name that is all lowercase\nand doesn't have any special characters. The following fields have suggestions for their content:\n\n - *categories* should be one of texture or work.\n - *image* must be defined, as some subfolder path under [assets/images/](docs/assets/images). We recommend that you put the image in the folder for the corresponding year, and that it is named based on `\u003cartist\u003e-\u003ctitle\u003e.jpg`. We have not tested beyond jpg so we are currently requiring it! (see example below).\n - *layout* you must leave as \"work\"\n - *tags* are up to you! These should describe your contribution, separated by commas.\n - *date* should be in the format YYYY-MM-DD HH:MM:SS\n - *author* is your name (or alias), although it's not required\n - *affiliation* (not shown in the example) can be your institution, or an affiliation that you have\n\nHere is a template you can start with:\n\n```\n---\nlayout: work\ntitle:  \"Circle Packing\"\ntags: circles, texture, cute\ncategories: texture\ndate:   2018-08-08 12:54:46\nauthor: Tim Holman\nwebsite: https://generativeartistry.com/tutorials/circle-packing/\nimage: 2018/tim-holman-circle-packing.jpg\n---\n\nYou can write a description here, if you like!\n```\n\nThe image path should be under the root \"assets/images\" in the repository. Thus for the above:\n\n```bash\n2018/tim-holman-circle-packing.jpg --\u003e assets/images/2018/tim-holman-circle-packing.jpg\n```\n\n**important** notice that the image name has the **same** unique resource identifier (`tim-holman-circle-packing`) as the post.\nThis is important for programmatic things, and it will be checked and tested.\n\nFinally, notice that the (more verbose if you like) description is at the bottom, under everything. Feel\nfree to write as little or as much as you like here.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsoch%2Fopensource-art","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvsoch%2Fopensource-art","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsoch%2Fopensource-art/lists"}