Simplified Installation Instructions with Pipenv

.gitignore

@@ -0,0 +1,107 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# OS generated
+.DS_Store

CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing Guide
+
+## Environment Setup
+
+TabPy suggests using [Pipenv](https://docs.pipenv.org) to configure and manage your development environment and provides facilities to enable this out of the box. To start, clone the source code and from the project root run:
+
+```sh
+pipenv install --dev
+```
+
+This will create a dedicated virtual environment containing all of the required packages.
+
+## Starting the Server
+
+From the project root, activate the virtual environment you created above via:
+
+```sh
+pipenv shell
+```
+
+Thereafter, simply navigate to tabpy-server/tabpy-server and run:
+
+```sh
+python tabpy.py
+```

Pipfile

@@ -0,0 +1,21 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+future = "*"
+futures = "==3.1.1"
+requests = "*"
+simplejson = "*"
+tornado-json = "*"
+tornado = "*"
+cloudpickle = "*"
+decorator = "*"
+python-dateutil = "*"
+genson = "*"
+jsonschema = "*"
+"809dc83" = {path = "./tabpy-client", edtiable = true}
+numpy = "*"
+
+[dev-packages]

README.md

@@ -6,15 +6,26 @@ Tableau Python Server (TabPy) is part of Tableau's expanding range of extensibil
 
 For all questions not related to the TabPy code (installation, deployment, connections, Python issues, etc.) and requests use [Server & Online Administration Forum](https://community.tableau.com/community/forums/server-administration) on [Tableau Community](https://community.tableau.com).
 
+## Installation
+
+TabPy is distributed as two separate packages, namely as _tabpy-client_ and _tabpy-server_. Both are available from PyPy and any combination of the packages can be installed via:
+
+```sh
+pip install tabpy-server
+pip install tabpy-client
+```
+
+Alternately, to work from the source code you should reference the [Contributing Guide](CONTRIBUTING.md) for instructions on how to configure your environment and install all dependencies.
+
+## About
+
 TabPy framework allows Tableau to remotely execute Python code. It has two components:
 
 1. A [server](server.md) process built on Tornado, which allows for the remote execution of Python code through a set of REST APIs. Code can either be immediately executed or persisted in the server process and exposed as a REST endpoint, to be called later.
 2. A [client library](client.md) that enables the deployment of such endpoints, based on Python functions.
 
 Tableau can connect to the TabPy server to execute Python code on the fly and display results in Tableau visualizations. Users can control data and parameters being sent to TabPy by interacting with their Tableau worksheets, dashboard or stories.
 
-You can find detailed **installation instructions** for TabPy server [HERE](server.md).
-
 To run Python code in your Tableau calculated fields, enter the address and port number for a TabPy server instance in Tableau.
 
 <p align="center"><img alt="Screenshot of Configuration on Tableau Desktop" src="external-service-configuration.png"></p>