TOMRIS
Cloud
DEVELOPER CENTER

Deploy from Terminal in a
Single Command.

Meet tomris-cloud-cli. Bundle your local codebase, configure contracts in YAML, and deploy agents or vector pipelines to the cloud from any workspace directory.

1

Install CLI Globally

Install the command-line utility globally via npm. This registers the tomris system command on your workspace runner.

Terminal

npm install -g tomris-cloud-cli
2

Authenticate

Authorize your local terminal. Standard login opens an OAuth window in your browser. Alternatively, authenticate on remote or headless systems using a Personal Access Token (PAT).

OAuth Login

tomris login

Token Login (PAT)

tomris login --token your_personal_access_token
3

Define Schema

Create a tomris.yaml file in your project root to describe the agent name, version, listening port, endpoint, and inputs/outputs structure.

Ignored Files: You can exclude temporary files or directories (like node_modules or .env) using a .tomrisignore file in your root workspace directory.

tomris.yaml

name: "my-smart-agent"
description: "This agent solves complex tasks using AI."
version: "1.0.0"
port: 3000
endpoint: "/chat"
inputs:
  - name: "query"
    type: "string"
outputs:
  - name: "response"
    type: "string"
4

Run Deploy

Execute the deployment command. The CLI packages your workspace directory, uploads the code, and builds serverless runtimes in milliseconds.

Deploy as Agent

tomris deploy --agent

Deploy as Tool

tomris deploy --tool

Override Flags

tomris deploy --agent --name "fast-assistant" --port 8080

CI/CD Pipeline Integration

Automate deployments inside GitHub Actions, GitLab CI, or Jenkins. By setting the environment variable TOMRIS_TOKEN on your runner system, the CLI executes deploys instantly without manual browser authorization prompts.

github-action.yml

name: Deploy Agent to Cloud
on:
  push:
    branches: [ main ]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Install Tomris CLI
        run: npm install -g tomris-cloud-cli
      - name: Deploy Swarm Node
        run: tomris deploy --agent
        env:
          TOMRIS_TOKEN: ${{ secrets.TOMRIS_TOKEN }}