Skip to main content
The Inworld CLI is a comprehensive command-line toolkit that streamlines the entire lifecycle of Runtime graph development - from initial prototyping to production deployment and continuous optimization. To download and install Inworld CLI, run the following command:
npm
npm install -g @inworld/cli

​
Commands

The CLI follows a logical command hierarchy that matches developer workflows: 
inworld
├── auth          # Authentication
│   ├── login     # User authentication (alias: inworld login)
│   ├── logout    # Sign out (alias: inworld logout)
│   ├── print-access-token  # Display access token
│   ├── print-api-key       # Display API key
│   └── status    # Show authentication status (alias: inworld status)
├── init          # Project creation with templates  
├── graph         # Graph management and deployment
│   ├── run       # Local testing and development (alias: inworld run)
│   ├── serve     # Local HTTP/gRPC servers (alias: inworld serve)
│   ├── deploy    # Cloud deployment (alias: inworld deploy)
│   ├── visualize # Generate architectural diagrams
│   └── variant   # A/B testing and experimentation
├── tts           # Text-to-speech synthesis
└── workspace     # Workspace management

​
Runtime Graph Development

Use the CLI to jumpstart your Runtime graph development, with easy to use templates and locatl testing capabilities. Use inworld init to intialize a project with one of our templates. 
# Initialize projects with battle-tested templates
inworld init --template llm_tts --name my-ai-app
Once you have a working graph, you can test it locally with inworld run. 
# Test locally with instant feedback
inworld run ./graph.ts '{"input": {"user_input": "test message"}}'
You can also visualize your graph: 
# Visualize complex graph architectures  
inworld graph visualize ./graph.ts --output ./docs/architecture.png
Graph visualization requires Graphviz to be installed on your system.
You can also serve your graph locally, with support for both http (with an optional Swagger UI) and gRPC. 
# Serve on HTTP Server with Swagger
inworld serve ./graph.ts --swagger  

# Serve on custom port
inworld serve ./graph.ts --port 8080

# Serve on custom host
inworld serve ./graph.ts --host 0.0.0.0 --port 3000

# Combine options
inworld serve ./graph.ts --host 0.0.0.0 --port 8080 --swagger

# gRPC server for high-performance applications
inworld serve ./graph.ts --transport grpc

​
Cloud Deployment

Once you’ve successfully built your graph, you can deploy it to Inworld Cloud to create a persistent, production-ready endpoint. See Cloud Deployment for more details. 
# Deploy to cloud with persistent endpoint
inworld deploy ./graph.ts

​
A/B Testing & Experimentation

You can use the CLI to create and manage graph variants, such as model or prompt changes, for A/B testing and experimentation. Your clients will automatically use the latest variants—no client-side updates required. 
# Register different variants for testing
inworld graph variant register -d baseline ./graph-v1.ts
inworld graph variant register -d experiment ./graph-v2.ts

# Configure traffic splits in Portal, monitor results

​
TTS

Use the CLI to quickly get started with Inworld TTS. Generate speech content with direct TTS commands, or create pipelines with TTS integrated. 
# Direct TTS synthesis for immediate use
inworld tts synthesize "Hello world" --voice Dennis --output audio.mp3

# Create AI graphs that use TTS
inworld init --template llm_tts

​
Telemetry

The Inworld CLI collects general usage data to help us improve the tool. Information such as the following are tracked:
  • Command execution time
  • CLI version
  • Command name
Managing Telemetry Inworld takes privacy and security seriously. You can opt-out if you prefer not to share any telemetry information. 
# Disable telemetry collection
inworld auth disable_telemetry

# Enable telemetry collection
inworld auth enable_telemetry

​
Next Steps

Ready to start building with the Inworld CLI?

Quickstart

Guide to installation, authentication, and first project setup

Deployment Guide

Deploy your graphs to production with persistent endpoints

​
Need Help?

  • Troubleshooting Guide - Common issues and solutions
  • CLI Help: Run inworld help or inworld [command] --help for detailed command information