🚀 Traylinx CLI

The command-line interface for the Traylinx Agent Network. Build, run, and share AI agents with Docker-powered simplicity.

Version: 0.2.1 | Python: 3.11+ | Status: Production-Ready

📚 Documentation Navigation

Installation

Instant Execution (No Install)

Run without installing using uvx:

uvx traylinx-cli --help

Using pipx (Recommended)

pipx installs CLI tools in isolated environments:

pipx install traylinx-cli

Using Homebrew (macOS/Linux)

brew tap traylinx/traylinx
brew install traylinx

Using pip

pip install traylinx-cli

💡 Short Alias: After installation, you can use tx as a shortcut:

tx --help    # Same as traylinx --help
tx run       # Same as traylinx run

Quick Start

# Create a new agent
traylinx init my-agent
cd my-agent

# Run locally with Docker
traylinx run

# View logs
traylinx logs

# Stop the agent
traylinx stop

🐳 Docker-Powered Agent Commands

Run agents anywhere with zero configuration — just Docker.

Run Options

traylinx run                  # Run in background (detached)
traylinx run --no-detach      # Run in foreground (see logs)
traylinx run --prod           # Use production config (Postgres)
traylinx run --native         # Skip Docker, use local Python

📦 Publishing & Sharing Agents

Share your agents with anyone via GitHub Container Registry.

Publish Your Agent

cd my-agent
traylinx publish
# → Building for linux/amd64,linux/arm64...
# → Pushing to ghcr.io/traylinx/my-agent:1.0.0
# → ✓ Published!

Run Any Agent

# The "Ollama experience" for agents
traylinx pull weather-agent
# → Pulling from ghcr.io/traylinx/weather-agent:latest
# → ✓ Agent running at http://localhost:8000

Core Commands

Configuration

Environment Variables

export TRAYLINX_ENV=dev                           # dev, staging, prod
export TRAYLINX_REGISTRY_URL=http://localhost:8000  # Override registry URL
export TRAYLINX_AGENT_KEY=my-agent                # Your agent key
export TRAYLINX_SECRET_TOKEN=your-token           # From Sentinel

Config File

Create ~/.traylinx/config.yaml:

registry_url: https://api.traylinx.com
credentials:
  agent_key: your-agent-key
  secret_token: your-secret-token

Architecture

traylinx/
├── cli.py            # Main CLI entry point
├── commands/
│   ├── init.py       # Create projects
│   ├── validate.py   # Validate manifests
│   ├── publish.py    # Publish to catalog
│   └── docker_cmd.py # Docker-powered commands
├── utils/
│   ├── docker.py     # Docker detection + compose
│   └── registry.py   # GHCR integration
├── api/
│   └── registry.py   # API client
├── models/
│   └── manifest.py   # Pydantic models
└── templates/        # Project templates

Development

# Install dev dependencies
uv sync

# Run tests
uv run pytest

# Run CLI locally
uv run traylinx --help

Requirements

• Python 3.11+ (for CLI)
• Docker (for run, publish, pull commands)
• Docker Buildx (for multi-arch builds, optional)

License

MIT License - Traylinx © 2025