Metadata-Version: 2.1
Name: marvin-python-toolbox
Version: 0.0.5
Summary: Marvin Python Toolbox
Home-page: https://github.com/marvin-ai/marvin-python-toolbox
Author: Daniel Takabayashi
Maintainer: Daniel Takabayashi
Maintainer-email: daniel.takabayashi@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: six (>=1.10.0)
Requires-Dist: bumpversion (>=0.5.3)
Requires-Dist: click (>=3.3)
Requires-Dist: jupyter (>=1.0.0)
Requires-Dist: jupyterlab (>=0.32.1)
Requires-Dist: pep8 (>=1.7.0)
Requires-Dist: virtualenv (>=15.0.1)
Requires-Dist: jsonschema (>=2.5.1)
Requires-Dist: python-slugify (>=0.1.0)
Requires-Dist: paramiko (>=2.1.2)
Requires-Dist: PyHive (>=0.3.0)
Requires-Dist: thrift (>=0.10.0)
Requires-Dist: thrift-sasl (>=0.2.1)
Requires-Dist: virtualenvwrapper (>=4.7.1)
Requires-Dist: requests (>=2.19.1)
Requires-Dist: python-dateutil (>=2.7.3)
Requires-Dist: path.py (>=7.2)
Requires-Dist: httpretty (>=0.9.5)
Requires-Dist: tornado (>=4.5.3)
Requires-Dist: gprof2dot
Requires-Dist: ujsonpath (>=0.0.2)
Requires-Dist: simplejson (>=3.10.0)
Requires-Dist: configobj (>=5.0.6)
Requires-Dist: findspark (>=1.1.0)
Requires-Dist: grpcio (>=1.13.0)
Requires-Dist: grpcio-tools (>=1.13.0)
Requires-Dist: joblib (>=0.11)
Requires-Dist: autopep8 (>=1.3.3)
Requires-Dist: progressbar2 (>=3.34.3)
Requires-Dist: urllib3 (>=1.21.1)
Requires-Dist: idna (>=2.5)
Requires-Dist: bleach (>=1.5.0)
Requires-Dist: numpy (>=1.16.2)
Requires-Dist: Unidecode (==1.0.23)
Provides-Extra: testing
Requires-Dist: tox (>=2.2.0) ; extra == 'testing'
Requires-Dist: mock (>=2.0.0) ; extra == 'testing'
Requires-Dist: pytest (>=2.9.2) ; extra == 'testing'
Requires-Dist: pytest-cov (<2.6,>=1.8.1) ; extra == 'testing'
Requires-Dist: pytest-watch (>=4.1.0) ; extra == 'testing'
Requires-Dist: pytest-testmon (>=0.8.2) ; extra == 'testing'
Requires-Dist: Keras (>=2.2.0) ; extra == 'testing'
Requires-Dist: tensorflow (>=1.8.0) ; extra == 'testing'

[![Build Status](https://travis-ci.org/marvin-ai/marvin-python-toolbox.svg)](https://travis-ci.org/marvin-ai/marvin-python-toolbox) [![codecov](https://codecov.io/gh/marvin-ai/marvin-python-toolbox/branch/master/graph/badge.svg)](https://codecov.io/gh/marvin-ai/marvin-python-toolbox)

# Marvin Toolbox v0.0.5

![](https://github.com/apache/incubator-marvin-website/blob/master/site/assets/themes/apache/img/logo.png?raw=true)

# Quick Start

## Review

**Marvin** is an open-source Artificial Intelligence platform that focuses on helping data scientists deliver meaningful solutions to complex problems. Supported by a standardized large-scale, language-agnostic architecture, Marvin simplifies the process of exploration and modeling.

## Getting Started
* [Installing Marvin (Ubuntu)](https://marvin.apache.org/marvin-platform-book/ch2_toolbox_installation/ubuntu/)
* [Installing Marvin (MacOS)](https://marvin.apache.org/marvin-platform-book/ch2_toolbox_installation/mac/)
* [Installing Marvin (Other OS) Vagrant](https://marvin.apache.org/marvin-platform-book/ch2_toolbox_installation/vagrant/)
* [Creating a new engine](#creating-a-new-engine)
* [Working in an existing engine](#working-in-an-existing-engine)
* [Command line interface](#command-line-interface)
* [Running an example engine](#running-a-example-engine)


### Creating a new engine
1. To create a new engine
```
workon python-toolbox-env
marvin engine-generate
```
Respond to the prompt and wait for the engine environment preparation to complete. Don't forget to start dev box before if you are using vagrant.

2. Test the new engine
```
workon <new_engine_name>-env
marvin test
```

3. For more information
```
marvin --help
```

### Working in an existing engine

1. Set VirtualEnv and get to the engine's path
```
workon <engine_name>-env
```

2. Test your engine
```
marvin test
```

3. Bring up the notebook and access it from your browser
```
marvin notebook
```

### Command line interface
Usage: marvin [OPTIONS] COMMAND [ARGS]

Options:
```
  --debug       #Enable debug mode.
  --version     #Show the version and exit.
  --help        #Show this command line interface and exit.
```

Commands:
```
  engine-generate     #Generate a new marvin engine project.
  engine-generateenv  #Generate a new marvin engine environment.
  engine-grpcserver   #Marvin gRPC engine action server starts.
  engine-httpserver   #Marvin http api server starts.
  hive-dataimport     #Import data samples from a hive databse to the hive running in this toolbox.
  hive-generateconf   #Generate default configuration file.
  hive-resetremote    #Drop all remote tables from informed engine on host.
  notebook            #Start the Jupyter notebook server.
  pkg-bumpversion     #Bump the package version.
  pkg-createtag       #Create git tag using the package version.
  pkg-showchanges     #Show the package changelog.
  pkg-showinfo        #Show information about the package.
  pkg-showversion     #Show the package version.
  pkg-updatedeps      #Update requirements.txt.
  test                #Run tests.
  test-checkpep8      #Check python code style.
  test-tdd            #Watch for changes to run tests automatically.
  test-tox            #Run tests using a new virtualenv.
```

### Running a example engine 

1. Clone the example engine from the repository
```
git clone https://github.com/marvin-ai/engines.git
```

2. Generate a new Marvin engine environment for the Iris species engine
```
workon python-toolbox-env
marvin engine-generateenv ../engines/iris-species-engine/
```

3. Run the Iris species engine
```
workon iris-species-engine-env
marvin engine-dryrun 
```

> Marvin is a project started at B2W Digital offices and released open source on September 2017.
> The project is donated to Apache Software Foundation on August 2018.


