🚀 Agentis CLI (Tomris Edition)

Agentis CLI is a powerful command-line interface designed for the Tomris ecosystem. This tool allows you to deploy code from your local directory as an Agent or a Tool to remote servers in seconds, while seamlessly managing authentication.

🌟 Key Features

• Effortless Deployment: Go live with a single command from any directory containing an agentis.yaml and a Dockerfile.
• Tomris OAuth Integration: Authenticate securely and quickly using your Tomris account.
• Flexible Configuration: Easily override metadata like name, description, and port during deployment.
• Smart IP Fallback: Automatically identifies the best network path (Public IP, Private IP, or Docker Network) for a stable connection to your target server.
• Ignore File Support: Take full control over uploaded files using .agentisignore.

📦 Installation

Install the CLI globally on your system using npm:

npm install -g tomris-agentis-cli

Once installed, the agentis command will be available from any terminal session.

🔑 Getting Started & Authentication

1. Login

Authorize the CLI with your Tomris account:

agentis login

This command will open your default web browser. Once you authorize the application, the CLI will be automatically authenticated.

2. Check Profile

Check which user is currently active:

agentis whoami

3. Logout

Clear local session tokens and logout:

agentis logout

🚢 Deployment

The core feature of Agentis CLI is direct code deployment to remote servers managed via Tomris.

Requirements

Your project directory must contain the following two files:

1. Dockerfile: Defines how your application should be containerized.
2. agentis.yaml: Contains metadata for the Agent or Tool.

Sample agentis.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"

Deployment Commands

To deploy as an Agent:

agentis deploy --agent

To deploy as a Tool:

agentis deploy --tool

Optional Flags

You can override agentis.yaml values directly from the command line:

• --name: Changes the Agent/Tool display name.
• --description: Updates the description.
• --port: Overrides the internal container port.

Example:

agentis deploy --agent --name "Fast-Assistant" --port 8080

.agentisignore File

To exclude specific directories or files (like node_modules, .git, or .env) from being uploaded to the server, create an .agentisignore file in your project root. It follows the standard .gitignore format.

⚙️ Configuration Hierarchy

The CLI checks for Tomris App credentials in the following order:

1. Command-line options (--client-id, --client-secret)
2. Environment variables (AGENTIS_CLIENT_ID, AGENTIS_CLIENT_SECRET)
3. Local configuration store saved during the first interactive login (~/.config/configstore/)

📄 License

This project is licensed under the ISC License.

Developed with ❤️ by the24s Technology