Metadata-Version: 2.1
Name: discoart
Version: 0.0.8.dev4
Summary: Create Disco Diffusion artworks in one line
Home-page: https://github.com/jina-ai/discoart
Author: Jina AI
Author-email: hello@jina.ai
License: MIT
Download-URL: https://github.com/jina-ai/discoart/tags
Project-URL: Source, https://github.com/jina-ai/discoart/
Project-URL: Tracker, https://github.com/jina-ai/discoart/issues
Description: ![](.github/banner.png)
        
        <p align="center">
        <b>Create compelling Disco Diffusion artworks in one line</b>
        </p>
        
        <p align=center>
        <a href="https://pypi.org/project/discoart/"><img src="https://img.shields.io/pypi/v/discoart?style=flat-square&amp;label=Release" alt="PyPI"></a>
        <a href="https://slack.jina.ai"><img src="https://img.shields.io/badge/Slack-3.1k-blueviolet?logo=slack&amp;logoColor=white&style=flat-square"></a>
        <a href="https://colab.research.google.com/github/jina-ai/discoart/blob/main/discoart.ipynb"><img src="https://img.shields.io/badge/Open-in%20Colab-brightgreen?logo=google-colab&style=flat-square" alt="Open in Google Colab"/></a>
        </p>
        
        DiscoArt is an elegant way of creating compelling Disco Diffusion<sup><a href="#example-application">[*]</a></sup> artworks for generative artists, AI enthusiasts and hard-core developers. DiscoArt has a modern & professional API with a beautiful codebase, ensuring high usability and maintainability. It introduces handy features such as result recovery and persistence, gRPC/HTTP serving w/o TLS, post-analysis, easing the integration to larger cross-modal or multi-modal applications.
        
        <sub><sup><a id="example-application">[*]</a> 
        Disco Diffusion is a Google Colab Notebook that leverages CLIP-Guided Diffusion to allow one to create compelling and beautiful images from text prompts.
        </sup></sub>
        
        👼 **Available to all**: fully optimized for Google Colab *free tier*! Perfect for those who don't own GPU by themselves.
        
        🎨 **Focus on creating not coding**: one-liner `create()` with a Pythonic interface and powerful features. Fetch real-time results anywhere anytime, no more worry on session outrage on Google Colab free tier.
        
        🏭 **Ready for integration & production**: built on top of [DocArray](https://github.com/jina-ai/docarray) data structure, enjoy smooth integration with [Jina](https://github.com/jina-ai/jina), [CLIP-as-service](https://github.com/jina-ai/clip-as-service) and other cross-/multi-modal applications.
        
        ## Install
        
        ```bash
        pip install discoart
        ```
        
        If you are not using DiscoArt under Google Colab, then other dependencies might be required.
        
        ## Get Started
        
        <a href="https://colab.research.google.com/github/jina-ai/discoart/blob/main/discoart.ipynb"><img src="https://img.shields.io/badge/Open-in%20Colab-brightgreen?logo=google-colab&style=flat-square" alt="Open in Google Colab"/></a>
        
        ### Create artworks
        
        ```python
        from discoart import create
        
        da = create()
        ```
        
        That's it! It will create with the [default text prompts and parameters](./discoart/resources/default.yml).
        
        ![](.github/create-demo.gif)
        
        ### Set prompts and parameters
        
        DiscoArt support parameters are [listed here](./discoart/resources/default.yml). You can specify them directly in `create()`:
        
        ```python
        from discoart import create
        
        create(text_prompts='A painting of sea cliffs in a tumultuous storm, Trending on ArtStation.',
               init_image='https://d2vyhzeko0lke5.cloudfront.net/2f4f6dfa5a05e078469ebe57e77b72f0.png',
               skip_steps=100)
        ```
        
        ![](.github/parameter-demo.gif)
        
        
        [This docs explains those parameters in very details.](https://docs.google.com/document/d/1l8s7uS2dGqjztYSjPpzlmXLjl5PM3IGkRWI3IiCuK7g/mobilebasic)
        
        ### Fetch results
        
        `create()` returns `da`, a [DocumentArray](https://docarray.jina.ai/fundamentals/documentarray/)-type object. It contains the following information:
        - All arguments passed to `create()` function, including seed, text prompts and model parameters.
        - The generated image and its intermediate images.
        
        This allows you to further post-process, analyze, export the results with powerful DocArray API.
        
        For example, you can display all final images in a grid:
        
        ```python
        da.plot_image_sprites(skip_empty=True, fig_size=(10, 10), show_index=True)
        ```
        ![](.github/all-results.png)
        
        Or the final image of one particular run:
        
        ```python
        da[0].display()
        ```
        
        ![](.github/display.png)
        
        You can zoom into that run and display images on the intermediate steps:
        
        ```python
        da[0].chunks.plot_image_sprites(skip_empty=True, fig_size=(10, 10), show_index=True)
        ```
        ![](.github/chunks.png)
        
        Finally, you can review its parameters via:
        
        ```python
        da[0].tags
        ```
        ![](.github/tags.png)
        
        ### Pull results
        
        If you are a free-tier Google Colab user, one annoy thing is the lost of sessions from time to time. With DiscoArt, you can easily recover the results by pulling the last session ID.
        
        1. Find the session ID. It appears on top of the image. 
        ![](.github/session-id.png)
        
        2. Pull the result via that ID **on any machine at any time**, not necessarily on Google Colab:
            ```python
            from docarray import DocumentArray
        
            da = DocumentArray.pull('discoart-3205998582')
            ```
        
        
        ### Verbose logs
        
        You can also get verbose logs by setting the following lines before import `discoart`:
        
        ```python
        import os
        
        os.environ['DISCOART_LOG_LEVEL'] = 'DEBUG'
        ```
        
        ## What's next?
        
        [Next is create](https://colab.research.google.com/github/jina-ai/discoart/blob/main/discoart.ipynb).
        
        😎 **If you are already a DD user**: you are ready to go! There is no extra learning, DiscoArt respects the same parameter semantics as DD5.2. So just unleash your creativity!
        - Note that DiscoArt does not support animation generation and `image_prompt` (which was marked as uneffective? in original DD 5.2).
        
        👶 **If you are a [DALL·E Flow](https://github.com/jina-ai/dalle-flow/) user**: you may want to take step by step, as Disco Diffusion works in a very different way than DALL·E. It is much more advanced and powerful: e.g. Disco Diffusion can take weighted & structured text prompts; it can initialize from a image with controlled noise; and there are way more parameters one can tweak. Impatient prompt like `"armchair avocado"` will give you nothing but confusion and frustration. I highly recommend you to check out the following resources before trying your own prompt:
        - [Zippy's Disco Diffusion Cheatsheet v0.3](https://docs.google.com/document/d/1l8s7uS2dGqjztYSjPpzlmXLjl5PM3IGkRWI3IiCuK7g/mobilebasic)
        - [EZ Charts - Diffusion Parameter Studies](https://docs.google.com/document/d/1ORymHm0Te18qKiHnhcdgGp-WSt8ZkLZvow3raiu2DVU/edit#)
        - [Disco Diffusion 70+ Artist Studies](https://weirdwonderfulai.art/resources/disco-diffusion-70-plus-artist-studies/)
        - [A Traveler’s Guide to the Latent Space](https://sweet-hall-e72.notion.site/A-Traveler-s-Guide-to-the-Latent-Space-85efba7e5e6a40e5bd3cae980f30235f#e122e748b86e4fc0ad6a7a50e46d6e10)
        
        <!-- start support-pitch -->
        ## Support
        
        - Join our [Slack community](https://slack.jina.ai) and chat with other community members about ideas.
        - Join our [Engineering All Hands](https://youtube.com/playlist?list=PL3UBBWOUVhFYRUa_gpYYKBqEAkO4sxmne) meet-up to discuss your use case and learn Jina's new features.
            - **When?** The second Tuesday of every month
            - **Where?**
              Zoom ([see our public events calendar](https://calendar.google.com/calendar/embed?src=c_1t5ogfp2d45v8fit981j08mcm4%40group.calendar.google.com&ctz=Europe%2FBerlin)/[.ical](https://calendar.google.com/calendar/ical/c_1t5ogfp2d45v8fit981j08mcm4%40group.calendar.google.com/public/basic.ics))
              and [live stream on YouTube](https://youtube.com/c/jina-ai)
        - Subscribe to the latest video tutorials on our [YouTube channel](https://youtube.com/c/jina-ai)
        
        ## Join Us
        
        DiscoArt is backed by [Jina AI](https://jina.ai) and licensed under [MIT License](./LICENSE). [We are actively hiring](https://jobs.jina.ai) AI engineers, solution engineers to build the next neural search ecosystem in open-source.
        
        <!-- end support-pitch -->
Keywords: discoart diffusion art dalle disco-diffusion generative-art creative-ai cross-modal multi-modal artwork
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Unix Shell
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database :: Database Engines/Servers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
