Getting started

Install

Install the latest release:

curl -fsSL https://seaport.run/install.sh | bash

Pin a specific version:

VERSION=0.1.0 curl -fsSL https://seaport.run/install.sh | bash

The installer accepts a few environment variables:

Variable	Meaning
`VERSION`	Version to install, without the leading `v`. Defaults to latest.
`INSTALL_DIR`	Where to put the binary. Defaults to `~/.local/bin`.
`BASE_URL`	Release base URL. Defaults to GitHub Releases.

Prefer building from source? With a Rust toolchain installed:

cargo install --path .

Then confirm it works:

seaport --help

Seaport runs tasks in Docker by default, so you need Docker installed and running before your first run.

Create a task skeleton:

seaport init --task acme/hello-world

This writes a hello-world/ folder with everything a task needs. Run it against its own oracle solution:

seaport run -p hello-world -a oracle

You will see the run start, the task build and execute, and a summary at the end. Results land under jobs/.

The repository ships with a ready example you can run without writing anything:

seaport run -p examples/tasks/basic-evaluation -a oracle

During development you can run straight from source:

cargo run -- run -p examples/tasks/basic-evaluation -a oracle