Skip to content

Finterion/finterion-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

finterion CLI

The Finterion platform command-line interface — a single static binary for macOS, Linux, and Windows. See docs/design.md for the full Phase 1 design.

Install

Homebrew (macOS, Linux)

brew install finterion/tap/finterion

Scoop (Windows)

scoop bucket add finterion https://github.com/finterion/scoop-bucket
scoop install finterion

Shell installer

curl -sSL https://get.finterion.com/cli | sh
iwr https://get.finterion.com/cli.ps1 | iex

Docker

docker run --rm -e FINTERION_TOKEN=$FINTERION_TOKEN \
  -v "$PWD":/work -w /work \
  ghcr.io/finterion/cli:latest backtest upload ./run.iafbt

Quick start

finterion login                       # paste your PAT (created in the web UI)
finterion whoami                      # confirm
finterion backtest upload ./run.iafbt # upload a study
finterion backtest list
finterion backtest get r-9f3a

Configuration

Source Example
Flag --profile staging --api-url https://api.staging.finterion.com
Env FINTERION_TOKEN, FINTERION_API_URL, FINTERION_PROFILE, FINTERION_OUTPUT, NO_COLOR, FINTERION_CONFIG_DIR
File $XDG_CONFIG_HOME/finterion/config.yaml (Unix) · %APPDATA%\Finterion\config.yaml (Windows)

Tokens are stored in the OS keyring (Keychain / Credential Manager / Secret Service). On headless systems the CLI falls back to a 0600 credentials file in the same directory and prints a one-time warning.

Build from source

go build ./cmd/finterion
./finterion --help

For releases, GoReleaser drives the full matrix:

goreleaser release --clean

Project layout

cmd/finterion         entrypoint
internal/cli          cobra commands
internal/api          HTTP client (will be OpenAPI-generated)
internal/auth         PAT format + keyring/file storage
internal/config       config.yaml + profile resolution
internal/iafbt        .iafbt folder reader + manifest validator
internal/upload       streaming, retrying, parallel artifact uploader
internal/ui           progress bars, JSON/text output
install/              install.sh + install.ps1 served from get.finterion.com
.goreleaser.yaml      brew tap, scoop bucket, deb/rpm, docker, cosign
Dockerfile            distroless image

License

Apache-2.0

About

The official Finterion CLI

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors