Installation

Seshat ships as a single binary. Pick the route that fits you: a one-line install script for end users, the Go toolchain for developers, or a source build if you want to hack on it.

Install with the script

What the script does

• Detects your system and downloads the matching binary from the GitHub release.
• Verifies its SHA-256 checksum, and stops if it does not match.
• Installs it in ~/.local/bin and adds that folder to your shell profile if needed.
• Prepares the runtime folder ~/.config/seshat-cli/ (it follows XDG_CONFIG_HOME when set). The database and your sessions are created on first run.

Options

# Pin a specific version
VERSION=v1.3.0 bash <(curl -fsSL https://raw.githubusercontent.com/KPO-Tech/seshat/main/scripts/install.sh)

# Install somewhere else
INSTALL_DIR=/usr/local/bin bash <(curl -fsSL https://raw.githubusercontent.com/KPO-Tech/seshat/main/scripts/install.sh)

Install with the Go toolchain

You need Go 1.25 or later.

go install github.com/KPO-Tech/seshat/cmd/cli@latest

Build from source

git clone https://github.com/KPO-Tech/seshat
cd seshat
make build

This produces two binaries in bin/:

Binary	Purpose
bin/seshat	Interactive terminal agent: chat, run tools, manage sessions
bin/seshat-grpc	gRPC server, to embed Seshat in a larger system

Use it as a library

To embed the runtime in your own Go application, add the SDK to your module:

go get github.com/KPO-Tech/seshat@latest

Next step