Getting Started

Getting Started with Zcrafter

Welcome to Zcrafter! This guide will walk you through the complete installation and setup process to get you up and running with your AI mainframe assistant.

Prerequisites

Zcrafter is a standalone binary that works on macOS, Linux, and Windows (via WSL).

  • macOS: 10.15 (Catalina) or later.
  • Linux: Any modern distribution with glibc 2.31+ (Ubuntu 20.04+, Debian 11+, etc.).
  • Windows: Requires WSL2 (Ubuntu recommended).

Installation

Install the latest version of Zcrafter with a single command. Open your terminal and run:

macOS / Linux

curl -fsSL https://zcrafter.com/install.sh | bash

Windows (PowerShell)

irm https://zcrafter.com/install.ps1 | iex

This script will:

  1. Detect your operating system and architecture.
  2. Download the latest stable binary.
  3. Install it to /usr/local/bin (or ~/.local/bin if sudo is unavailable).

Verifying Installation

After the script completes, verify that Zcrafter is accessible:

zcrafter --version

You should see an output similar to Zcrafter version 3.1.36.

First-Time Setup

Zcrafter is designed to be "zero-config" to start. You don't need to edit any files manually.

  1. Launch Zcrafter: Simply type zcrafter in your terminal and press Enter.

  2. Interactive Wizard: On your first run, Zcrafter will present a friendly setup wizard.

    • Select Provider: We strongly recommend choosing Zcrafter.

      Why? Zcrafter Pro offers a flat monthly rate that is significantly cheaper than paying per-token for state-of-the-art models. Get your key here.

    • Enter API Key: Paste your Zcrafter API Key.
  3. Mainframe Connection: After setting up the AI, Zcrafter may ask if you want to connect to a mainframe immediately.

    • Connect Now: Enter your Host, Port, User, and Password if you're ready to work.
    • Connect Later: Press Esc to skip this step. You can always connect later using Ctrl+M.

What's Next?

Congratulations! You have successfully installed Zcrafter. You are now dropped into the main chat interface.

  • Start Chatting: Ask a question like "How do I allocate a dataset?"
  • Explore Features: Learn about Mainframe Integration.
  • Master the Interface: Read our guide on Using Zcrafter.