Getting Started
Configuration
Environment variables, quality thresholds, and directory paths.
AutoFlow is configured through environment variables defined in src/autoflow/config.py. All settings have sensible defaults.
LLM Provider
| Variable | Default | Description |
|---|---|---|
DEFAULT_LLM_PROVIDER | "mock" | LLM provider to use (openai, anthropic, gemini, ollama, mock) |
OLLAMA_BASE_URL | "http://localhost:11434" | Ollama server address |
When using the Ollama provider, AutoFlow automatically discovers locally installed models. Use --model to specify a model, or AutoFlow will prompt you to choose if the default (llama3) isn't available. See LLM Providers for details.
Quality Thresholds
These control the evaluate-critique loop pass criteria:
| Variable | Default | Description |
|---|---|---|
PASS_THRESHOLD_CORRECTNESS | 4 | Minimum correctness score (1-5) to pass |
PASS_THRESHOLD_FORMAT_VALIDITY | 5 | Minimum format validity score (must be exact) |
PASS_THRESHOLD_EDIT_MINUTES | 15 | Maximum estimated human edit minutes |
MAX_CRITIQUE_ITERATIONS | 2 | Maximum evaluate-critique cycles before stopping |
Analytics
| Variable | Default | Description |
|---|---|---|
AWC_ANALYTICS_ENABLED | true | Enable pipeline run logging to logs/analytics/ |
Disable analytics per-run with the --no-analytics CLI flag.
Directory Paths
These are auto-resolved relative to the package root:
| Path | Location | Contents |
|---|---|---|
PROMPTS_DIR | prompts/ | 9 prompt templates (.txt) |
PERSONAS_DIR | personas/ | 8 persona definitions (.txt) |
SCHEMAS_DIR | schemas/ | JSON Schema files |
WORKFLOWS_DIR | workflows/ | All workflow files |
CATALOG_DIR | workflows/starter_templates/ | 20 starter templates |
CUSTOM_WORKFLOWS_DIR | workflows/custom_workflows/ | User-customized workflows |
REGISTRY_DIR | node_registry/ | Node registry YAML definitions |
NODE_SCHEMAS_DIR | schemas/nodes/ | Auto-generated per-node JSON Schemas |
Example: Strict Quality Settings
export PASS_THRESHOLD_CORRECTNESS=5
export PASS_THRESHOLD_FORMAT_VALIDITY=5
export PASS_THRESHOLD_EDIT_MINUTES=5
export MAX_CRITIQUE_ITERATIONS=3
python -m autoflow "Build a document review pipeline" --mode generate --provider openaiThis configuration requires near-perfect outputs and allows an extra critique iteration to get there.