Metadata-Version: 2.1
Name: toolchest-client
Version: 0.9.31
Summary: Python client for Toolchest
Home-page: https://github.com/trytoolchest/toolchest-client-python
License: AGPL-3.0-only
Author: Bryce Cai
Author-email: bcai@trytoolchest.com
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: boto3 (>=1.18.29,<2.0.0)
Requires-Dist: docker (>=5.0.3,<6.0.0)
Requires-Dist: importlib-metadata (>=1.0,<2.0); python_version < "3.8"
Requires-Dist: python-dotenv (>=0.18.0,<0.19.0)
Requires-Dist: requests (>=2.25.1,<3.0.0)
Requires-Dist: sentry-sdk (>=1.5.8,<2.0.0)
Project-URL: Bug Tracker, https://github.com/trytoolchest/toolchest-client-python/issues
Project-URL: Documentation, https://docs.trytoolchest.com/
Project-URL: Repository, https://github.com/trytoolchest/toolchest-client-python
Description-Content-Type: text/markdown

# Toolchest Python Client

**Toolchest** runs computational biology software in the cloud with just a few lines of code. 
You can call Toolchest from anywhere Python or R runs, using input files located on your computer or S3.

This package contains the **Python** client for using Toolchest.
For the **R** client, [see here](https://github.com/trytoolchest/toolchest-client-r).

## [Documentation & User Guide](https://docs.trytoolchest.com/)

## Installation

The Toolchest client is available [on PyPI](https://pypi.org/project/toolchest-client):
``` shell
pip install toolchest-client
```

## Usage

Using a tool in Toolchest is as simple as:

``` python
import toolchest_client as toolchest
toolchest.set_key("YOUR_TOOLCHEST_KEY")
toolchest.kraken2(
  tool_args="",
  inputs="path/to/input.fastq",
  output_path="path/to/output.fastq",
)
```

For a list of available tools, see the [documentation](https://docs.trytoolchest.com/docs#-tools).

## Configuration

To use Toolchest, you must have an authentication key stored
in the `TOOLCHEST_KEY` environment variable.

``` python
import toolchest_client as toolchest
toolchest.set_key("YOUR_TOOLCHEST_KEY") # or a file path containing the key
```

Contact Toolchest if:

-   you need a key
-   you’ve forgotten your key
-   the key is producing authentication errors.

