FluxLoop CLI

Command-line interface for managing FluxLoop projects, generating inputs, and running agent simulations.

Installation

pip install fluxloop-cli

Version

Current version: 0.2.1

Features

• 🎯 Project Management: Initialize and configure simulation projects
• 📝 Input Generation: Create test input variations using LLM or deterministic strategies
• 🧪 Experiment Execution: Run batch simulations with configurable iterations
• 📊 Result Parsing: Convert raw artifacts to human-readable formats
• 🔴 Recording Mode: Capture and replay complex function arguments
• ⚙️ Configuration: Structured YAML-based configuration system

Quick Example

# Initialize a new project
fluxloop init project --name my-agent
cd fluxloop/my-agent

# Generate 50 input variations
fluxloop generate inputs --limit 50

# Run experiment
fluxloop run experiment

# Parse results
fluxloop parse experiment experiments/my_agent_experiment_*/

Key Commands

Project Initialization

fluxloop init project --name <project-name>

Creates a new FluxLoop project with:

• configs/ directory (project, input, simulation, evaluation configs)
• .env file for environment variables
• examples/ with sample agent code
• inputs/, recordings/, experiments/ directories

Input Generation

fluxloop generate inputs [--limit 100] [--mode llm]

Generate input variations from base inputs defined in configs/input.yaml.

Experiment Execution

fluxloop run experiment [--iterations 10]

Run simulation experiment using configuration from configs/simulation.yaml.

Recording Mode

fluxloop record enable   # Enable argument recording
fluxloop record disable  # Disable recording
fluxloop record status   # Check recording state

Configuration

fluxloop config set-llm <provider> <api-key> [--model <model>]

Update LLM provider settings in configs/input.yaml.

Configuration Files (v0.2.0)

FluxLoop CLI uses a multi-file configuration structure:

File	Purpose
configs/project.yaml	Project metadata, collector settings
configs/input.yaml	Personas, base inputs, LLM settings
configs/simulation.yaml	Runner, iterations, replay args
configs/evaluation.yaml	Evaluator definitions

What's Next?

• Installation - Detailed installation guide
• Project Setup - Initialize your first project
• Commands Reference - Full command documentation
• Configuration - Config file reference
• Runner Targets - Connect your code to simulations

---

Need help? Run fluxloop --help or check GitHub Issues.