Skip to content

🌌 Stargate & P2P FAQ: The Full Picture

Context: This FAQ explores the integrated vision of Traylinx Stargate, the Traylinx CLI, and Stargate Station.

Q: How do I install Traylinx?

Answer: You have two installation paths, both resulting in the same software:

Path 1: CLI-First (Developer Flow)

This is the "Ubuntu minimal install" approach—start with the engine, add the cockpit if you want it.

# Step 1: Install CLI (via Homebrew or pipx)
brew install traylinx
# OR
pipx install traylinx-cli

# Step 2 (Optional): Add GUI Extension
traylinx install gui
# This prompts: "Would you like to install Stargate Station (GUI)? [y/N]"

Path 2: Station-Bundled (User Flow)

This is the "One-Click Installer" approach for non-developers—download a DMG/EXE/AppImage that includes EVERYTHING.

  1. Download: Stargate-Station-1.0.0-macos.dmg
  2. Install: Drag to Applications.
  3. Result: The installer automatically bundles the CLI inside the app. On first launch, it sets up ~/.traylinx/ for you.

Both paths result in the same setup: Traylinx CLI + Stargate Station GUI sharing the same identity and configuration.

Q: Can Stargate Station do everything the CLI can do?

Answer: Yes, for all things related to the Stargate Agent Network, the goal is 100% Parity.

CLI Command Stargate Station UI
traylinx stargate identity generate "Generate Identity" Button in Settings
traylinx stargate discover "Discover" Search Panel (Live List)
traylinx stargate call Interactive Chat Interface
traylinx stargate connect Toggle Switch for "Network Status"
traylinx run "Start Agent" Button

Q: What does "Integrated Stargate" in the CLI actually enable?

Answer: Integrating Stargate directly into the CLI (traylinx stargate ...) transforms the CLI from a simple API client into a P2P Node.

It enables: * Decentralized Setup: Run an agent from your laptop (traylinx run --stargate) and have it automatically punch through NAT (via libp2p) to join the global mesh. * Local Discovery: Run traylinx discover to see all other agents currently active in your local network or the global NATS/libp2p cluster. * Headless Orchestration: Script multi-agent workflows without needing a central server. Agent A calls Agent B via the CLI's internal P2P bridge.

Q: How does "Distribution" work on Stargate?

Answer: In a traditional app store, "Distribution" means uploading a binary to a server. On Stargate, Distribution means Manifest Propagation.

  1. Publish: You run traylinx publish. This sends your traylinx-agent.yaml to the Agent Registry (Centralized) or broadcasts it to the Stargate Gossip Network (Decentralized).
  2. Discovery: When an agent (or a user via Stargate Station) wants to find a service, they ask the network.
  3. Direct Connection: Once found, communication happens directly between peers. Stargate Station essentially becomes a "Browser for Agents," where each agent is a P2P destination rather than a URL.

Q: Can Stargate Station be used to set up the network?

Answer: Yes. While the CLI is optimized for speed and automation, Stargate Station provides a visual "Setup Wizard": * Visual key generation and backup. * One-click connection to bootstrap nodes. * Visual monitoring of NAT traversal status (are you reachable?). * Real-time logs of A2A calls.

Q: Summarize the "Full Picture" of the Agentica ecosystem.

Answer: 1. The Blueprint: traylinx-agent-template (How to build an agent). 2. The Protocol: traylinx-stargate (How agents talk P2P). 3. The Engine: traylinx-cli (How developers manage agents). 4. The App Store/Browser: Stargate Station (How users find and use agents). 5. The Infrastructure: traylinx_core (The heavy-lifting services like Registry and Sentinel that provide stability to the decentralized mesh).