Metadata-Version: 2.1
Name: neuralart
Version: 1.1.1
Summary: A library for rendering generative art from a randomly initialized neural network.
Home-page: https://github.com/dstein64/neuralart
Author: Daniel Steinberg
Author-email: ds@dannyadam.com
License: MIT
Keywords: neural-networks,generative-art
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Artistic Software
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
License-File: LICENSE

.. image:: https://github.com/dstein64/neuralart/workflows/build/badge.svg
    :target: https://github.com/dstein64/neuralart/actions

neuralart
=========

A library and command line utility for rendering generative art from a randomly
initialized neural network.

Based on the following blog posts and pages from `studio otoro <http://otoro.net/>`__

- `Neural Network Generative Art in Javascript <http://blog.otoro.net/2015/06/19/neural-network-generative-art/>`__
- `Generating Abstract Patterns with TensorFlow <http://blog.otoro.net/2016/03/25/generating-abstract-patterns-with-tensorflow/>`__
- `Neurogram <http://blog.otoro.net/2015/07/31/neurogram/>`__
- `Interactive Neural Network Art <http://otoro.net/ml/netart/>`__

Requirements
------------

*neuralart* supports Python 3.x.

Linux, Mac, and Windows are supported.

Other operating systems may be compatible if the dependencies can be properly installed.

Dependencies
~~~~~~~~~~~~

- PyTorch
- Pillow

Installation
------------

`neuralart <https://pypi.python.org/pypi/neuralart>`__ is available on PyPI,
the Python Package Index.

::

    $ pip install neuralart

Command Line Utility
--------------------

There is a command line utility for generating images. Use the :code:`--help`
flag for more information.

::

    $ neuralart --help

Example
~~~~~~~

::

    $ neuralart \
          --seed 2 \
          --xres 2048 \
          --hidden-std 1.2 \
          example.png

.. image:: https://github.com/dstein64/neuralart/blob/master/images/example-400.png?raw=true
   :target: https://github.com/dstein64/neuralart/blob/master/images/example.png

Library Example Usage
---------------------

See `example.py <https://github.com/dstein64/neuralart/blob/master/example.py>`__.

License
-------

The code in this repository has an `MIT License <https://en.wikipedia.org/wiki/MIT_License>`__.

See `LICENSE <https://github.com/dstein64/neuralart/blob/master/LICENSE>`__.


