Metadata-Version: 2.4
Name: ikomia-cli
Version: 0.9.1
Summary: Ikomia command line interface
Author-email: Denis Cavrois <denis.cavrois@ikomia.com>, Ludovic Barusseau <ludovic.barusseau@ikomia.com>
Platform: any
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click<9.0.0,>=8.1.3
Requires-Dist: ikomia-client<2.0.0,>=0.2.0
Requires-Dist: pyyaml<7.0.0,>=6.0.0
Requires-Dist: requests<3.0.0,>=2.28.1
Requires-Dist: requests_toolbelt<2.0.0,>=1.0.0
Requires-Dist: rich<13.0.0,>=12.6.0
Requires-Dist: yarl<2.0.0,>=1.9.4
Provides-Extra: full
Requires-Dist: cookiecutter<3.0.0,>=2.1.1; extra == "full"
Requires-Dist: ikomia<1.0.0,>=0.11.1; extra == "full"

# Ikomia command line interface

CLI that provides methods to communicate with the Ikomia deployment platform. 
One of the main features is the ability to push your Ikomia workflow and then be able to deploy it on 
a suitable compute infrastructure (serverless, CPU or GPU).

[Ikomia deployment platform](https://app.ikomia.ai)

## Installation
```commandline
python -m venv .venv
source .venv/bin/activate
pip install ikomia-cli
```

## Manage Ikomia deployment platform

**Authentication** 

You will be invited to enter your account login and password. You will then receive your connection token 
with the given duration validity. Export it to your console session for the next calls of **ikcli**.
```commandline
ikcli login --token-ttl 3600
```

**Project main commands**

List your projects
```commandline
ikcli project ls
```

Create new project
```commandline
ikcli project add <project_name> <namespace>
```

Push workflow
```commandline
ikcli project push <project_name> <workflow_local_path>
```

**Workflow main commands**

List project workflows
```commandline
ikcli project workflow ls <project_name>
```

Show workflow details
```commandline
ikcli project workflow show <project_name> <workflow_name>
```

Deploy workflow
```commandline
ikcli project workflow deploy <project_name> <workflow_name> <provider> <region> <{SERVERLESS, CPU or GPU} --size {XS,S,M,L or XL} 
```

**Deployment main commands**

List deployments of a given workflow
```commandline
ikcli project deployment ls <project_name> <workflow_name>
```

Get deployment logs
```commandline
ikcli project deployment logs <project_name> <workflow_name>
```

Get deployment usage
```commandline
ikcli project deployment usage <project_name> <workflow_name>
```

## Manage Ikomia algorithms

List local algorithms
```commandline
ikcli algo local ls
```

Create a new empty algorithm
```commandline
ikcli algo local create your_new_algo
```

List algorithms from Ikomia HUB
```commandline
ikcli hub ls
```

Show Ikomia HUB algorithm details
```commandline
ikcli hub show algo_name
```
