Skip to content
  • Documentation
  • Tutorials
  • Blogs
  • Product

What's on this Page

    • 1. Get access and install the prerequisites
    • 2. Download the CLI and the AI Agent
    • 3. Set the environment variables and start Studio
    • 4. Create your first test
  1. Step
  2. AI
  3. Step AI Agent
  4. Getting started with the Step AI Agent
  5. Getting started with the Step AI Agent in Step Studio
This article references one of our previous releases, click here to go to our latest version instead.

Getting started with the Step AI Agent in Step Studio

What's on this Page

    • 1. Get access and install the prerequisites
    • 2. Download the CLI and the AI Agent
    • 3. Set the environment variables and start Studio
    • 4. Create your first test

Step Studio is part of the Step CLI. It opens in your browser and runs on your own computer. Follow these steps to install the CLI and create your first test with AI. No Step instance is needed for this.

1. Get access and install the prerequisites

  • Java 21 or later: a Java Runtime Environment (JRE) is sufficient; a JDK also works. On Linux, prefer your OS package manager. OpenJDK distributions such as Azul Zulu and Eclipse Temurin are suitable.
  • Node.js 24 or later: download Node.js and install it on your computer.
  • Enterprise downloads access: use your Step Enterprise Credentials, or request access if you do not have them.
  • A Studio license with AI enabled: contact us if you need one.
  • An Anthropic API key: obtain a key scoped to an Anthropic workspace from your organization’s administrator or the Anthropic Console.
Currently, only Anthropic (Claude) is supported. Support for additional AI providers is planned.

2. Download the CLI and the AI Agent

Create a folder called Step in your home folder. Save both downloads below in it:

Step CLI 3.31.0 — includes Studio (Enterprise edition):

Operating system Enterprise
Windows Download step.exe
macOS Download step
Linux

The Step AI Agent: download the AI Agent package (.jar). Save it in the same Step folder without renaming it. Its filename follows the pattern step-ai-agents-VERSION.jar, where VERSION is the version in the downloaded filename.

Copy your Studio license file directly into your home directory as step-studio-license.dat, one level above the Step folder:

Operating system Home directory (license)
Windows C:\Users\your-name
macOS /Users/your-name
Linux /home/your-name

3. Set the environment variables and start Studio

An environment variable is an operating-system setting passed to programs you start. Studio needs two: the location of the AI Agent file and your Anthropic API key.

Open PowerShell on Windows, or Terminal on macOS/Linux. Before running the commands for your operating system, replace VERSION with the version in your downloaded JAR filename and YOUR_ANTHROPIC_API_KEY with your own key. $HOME means your home folder; keep that part as written.

Windows — PowerShell:

$env:PATH = "$HOME\Step;" + $env:PATH
$env:STEP_STUDIO_AI_AGENT_PACKAGE = "$HOME\Step\step-ai-agents-VERSION.jar"
$env:ANTHROPIC_API_KEY = "YOUR_ANTHROPIC_API_KEY"
step studio

macOS/Linux — Terminal (Bash or Zsh):

chmod +x "$HOME/Step/step"
export PATH="$HOME/Step:$PATH"
export STEP_STUDIO_AI_AGENT_PACKAGE="$HOME/Step/step-ai-agents-VERSION.jar"
export ANTHROPIC_API_KEY="YOUR_ANTHROPIC_API_KEY"
step studio

These settings apply to this PowerShell or Terminal session. Set them before starting Studio, and launch Studio from that same window. If Studio is already running, stop it and restart it after setting the variables. Repeat the commands when starting from a new terminal window.

Studio opens at http://localhost:8080. Keep the terminal window open while using it. To stop Studio, type q in that window.

If step studio does not start, run java -version, node --version, and step --version in the same window. Check for Java 21+, Node.js 24+, and Step 3.31.0. If a command is not found, reopen the terminal after installing its prerequisite and repeat the setup commands above.

4. Create your first test

  1. In Studio, click New package, choose a name and a folder, and create the package.
  2. Open AI Generate → Generate, then select Define Test Cases.
  3. Enter Test case name: wikipedia_black_hole.
  4. Enter Test description: Go to https://en.wikipedia.org/wiki/Black_hole and check that the main heading reads Black hole.
  5. Click Generate test cases. The AI Agent creates and runs the automation in your open package. Allow several minutes and follow the run under Generations.
The Generate screen in Step Studio, reached from AI Generate in the left-hand navigation, holding the Wikipedia example from this page. Select how to generate offers Describe Your Goal or Define Test Cases, with Define Test Cases selected. One test case card, marked Complete, holds a required Test case name reading wikipedia_black_hole and a required Test description reading Go to the Black hole article and assert the title is Black hole. A Form and Markdown toggle sits above the card, an Add test case button below it, and Advanced options for shared automation instructions at the foot. A Generate test cases button sits at the top right.
Refresh the package when the AI Agent finishes. Click the refresh button beside the package name to load the generated automation. Then open Plans to inspect the generated test and run it again.

Next: follow the Studio AI tutorial to create a complete checkout test and read its results. The Studio documentation covers the other editor features.

See Troubleshooting for common execution errors, and Data and privacy for model data handling.

Topics: AI Automation Packages Browse all topics

Related documentation

  • Getting started with the Step AI Agent from the CLI
  • Using the Step AI Agent on your Step instance
  • Tutorials
  • Step Studio
  • Configuration
  • Home
  • Whats new?
  • Release Strategy
  • Set up
  • Administration
  • SaaS guide
  • User guide
  • Developer guide
  • DevOps
  • AI
    • Step MCP Server
    • Step AI Agent
      • Getting started
        • Step Studio
        • CLI
        • Step Platform
      • Tutorials
      • Configuration
      • Data and privacy
  • Plugins
  • Libraries
Step Logo
    • Documentation
    • Tutorials
    • Blogs
    • Product
    • Home
    • Whats new?
    • Release Strategy
    • Set up
    • Administration
    • SaaS guide
    • User guide
    • Developer guide
    • DevOps
    • AI
      • Step MCP Server
      • Step AI Agent
        • Getting started
          • Step Studio
          • CLI
          • Step Platform
        • Tutorials
        • Configuration
        • Data and privacy
    • Plugins
    • Libraries