Quick start

This page takes you from installation to a successful operation. No account or API token is needed for the example.

Install Picoo

You need Rust and Cargo for the current installation method.

cargo install --git https://github.com/picoo-dev/picoo.git --locked

Check the installation:

picoo --help
picoo doctor

Tip

If your terminal cannot find picoo, restart it or add Cargo’s binary directory to your PATH.

Find an operation

Describe the result you want:

picoo search "say hello to a person"

The result shows an operation ID and its inputs. For this example, use picoo/demo/hello.

Run the operation

picoo run picoo/demo/hello --input name=Nahid

You should receive a result like this:

{
  "result": {
    "greeting": "Hello, Nahid!"
  }
}

If the operation is not installed, Picoo fetches it from the configured Picoo Registry. Later runs use the installed copy.

Run a fixed version

Pin a version when the same input must use the same operation release:

picoo run picoo/demo/hello --version 0.1.0 --input name=Nahid

Add --offline after installation to prevent Registry access:

picoo run picoo/demo/hello --offline --version 0.1.0 --input name=Nahid

Recap

You have now:

• Installed Picoo.
• Checked the required runtimes.
• Found an operation by describing a task.
• Run a versioned operation with typed input.

Next, create your first operation.