Metadata-Version: 2.1
Name: tflyrics
Version: 0.1
Summary: Generate lyrics with TensorFlow and the Genius API
Home-page: https://github.com/ggiuffre/tf-lyrics
Author: Giorgio Giuffrè
Author-email: giorgiogiuffre23@gmail.com
License: UNKNOWN
Project-URL: Documentation, https://ggiuffre.github.io/tf-lyrics
Project-URL: Source, https://github.com/ggiuffre/tf-lyrics/
Project-URL: Tracker, https://github.com/ggiuffre/tf-lyrics/issues
Description: # tflyrics
        <a href="https://codeclimate.com/github/ggiuffre/tf-lyrics/maintainability"><img src="https://api.codeclimate.com/v1/badges/b0845d2d158fc06c1677/maintainability" /></a>
        
        Generate intriguing lyrics with TensorFlow and an internet connection.
        
        `tflyrics` is a Python package that allows you to easily select lyrics of
        specific artists from [genius.com](https://genius.com/), and train a deep
        neural network to generate text that sounds similar to those lyrics. This
        work was inspired from [The Unreasonable Effectiveness of Recurrent Neural
        Networks](http://karpathy.github.io/2015/05/21/rnn-effectiveness/) and
        [Text generation with an
        RNN](https://www.tensorflow.org/tutorials/text/text_generation).
        
        Example:
        
        ```python
        from tflyrics import Poet, LyricsGenerator
        
        artists = ['Bob Dylan', 'Tim Buckley', 'The Beatles']
        gen = LyricsGenerator(artists, per_artist=5)
        ds = gen.as_dataset(batch_size=16)
        
        p = Poet()
        p.train_on(ds, n_epochs=10)
        poem = p.generate(start_string='Hey ', n_gen_chars=1000)
        print(poem)
        ```
        
        Quick paraphrase: a `LyricsGenerator` object makes it easy for you to create a
        data pipeline that feeds from the Genius API directly into a recurrent neural
        network; a `Poet` object is a wrapper around a recurrent neural network.
        
        Note that the Genius API requires you to have an **access token**. Without
        that, `tflyrics` won't be able to get lyrics for you. You can get an access
        token for free at [docs.genius.com](https://docs.genius.com/). Once you have
        it you can either pass it under the `token` argument of a `LyricsGenerator`
        constructor, or store it as en environment variable (with `export
        GENIUS_ACCESS_TOKEN='<your token here>'`). `tflyrics` will detect this
        environment variable automatically, if it exists.
        
Keywords: genius tensorflow lyrics scraper tflyrics
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Text Processing
Requires-Python: >=3.6
Description-Content-Type: text/markdown
