Website | Community | Blog

User Manual | API Reference

Get Early Access

instill is the command line interface for Instill Cloud.

Table of contents

• What is Instill Cloud?
• Installation
• Issues and discussions

What is Instill Cloud?

Instill AI is on a mission to make AI accessible to everyone. With Instill Cloud, one can easily build up a data pipeline to transform unstructured data to meaningful data representations, starting to tap on the value of unstructured data.

Instill Cloud provides a Pipeline consisting of Source Connector, Model, Logic Operator and Destination Connector components, to process unstructured data to their meaningful data representations.

Installation

macOS

instill is available via Homebrew and as a downloadable binary from the releases page.

Homebrew

To install:

brew install instill-ai/tap/instill

To upgrade:

brew upgrade instill-ai/tap/instill

Usage examples

# log in
$ instill auth login

# list pipelines
$ instill api pipelines

# list models
$ instill api models

# add parameters to a GET request
$ instill api models?visibility=public

# list instances
$ instill instances list

# selected a default instance
$ instill instances set-default my-host.com

# add an instance
$ instill instances add instill.localhost \
    --oauth2 auth.instill.tech \
    --audience https://instill.tech \
    --issuer https://auth.instill.tech/ \
    --secret YOUR_SECRET \
    --client-id CLIENT_ID

# add parameters to a POST request
$ instill api -X POST oauth2/token?audience=...&grant_type=...

# add nested JSON body to a POST request
$ jq -n '{"contents":[{"url": "https://artifacts.instill.tech/dog.jpg"}]}' | instill api demo/tasks/classification/outputs --input -

# set a custom HTTP header
$ instill api -H 'Authorization: Basic mytoken' ...

Issues and discussions

Please directly report any issues in Issues or Pull requests, or raise a topic in Discussions.