EulerStack CLI 레퍼런스

eulerwa 제품군 공통 CLI 컨벤션을 따릅니다. 모든 메시지는 i18n 대상입니다 (ko 기본, en/zh/ja/es 지원).

English version: cli_en.md

Entry Point

eulerstack [--lang ko|en|zh|ja|es] [OPTIONS] COMMAND [ARGS]...

Root option:

i18n 적용 범위: - --help / 서브커맨드 --help — 모두 번역됨 - 일반 로그/완료 메시지 (예: OK: ... is valid.) - 경고 / 에러 3줄 포맷 — 메시지 본문은 번역, Fix: / See: 레이블은 고정

i18n 적용 범위 밖 (고정): - 명령 이름: validate, explain, compile, schema, presets - 옵션 이름: --preset, --output, --output-dir, --report, --validate-only, --print-config, --dry-run, --lang - Exit 코드: 성공 0, 실패 1

Common Option Conventions (eulerwa style)

All options use kebab-case (e.g., --validate-only, --print-config).

Language Examples

# Korean (default)
eulerstack validate --preset my_model.yml

# English
eulerstack --lang en validate --preset my_model.yml

# Chinese / Japanese / Spanish
eulerstack --lang zh explain --preset my_model.yml
eulerstack --lang ja explain --preset my_model.yml
eulerstack --lang es explain --preset my_model.yml

# Via environment variable
EULERSTACK_LANG=en eulerstack validate --preset my_model.yml

Top-Level Commands

eulerstack validate

Validate a YAML spec file against the schema.

# Basic validation
eulerstack validate --preset my_model.yml

# Full report with realism checks and parameter estimate
eulerstack validate --preset my_model.yml --report

# Explicit validate-only (for consistency with eulerwa CLI family)
eulerstack validate --preset my_model.yml --validate-only

• Exit 0: valid (no schema errors)
• Exit 1: validation error(s) printed in 3-line format

--report output includes: - Schema validation status - Estimated parameter count - Realism warnings (head_dim, MoE ratio, seq_len, etc.) - INFO summary

eulerstack explain

Show a human-readable summary of a YAML spec.

eulerstack explain --preset configs/presets/llm_2b_simple.yml

Output includes: - Model identity (name, dimensions, dtype) - Layer templates (mixer, ffn, norm, residual) - Layer schedule (template x repeat) - Estimated parameter count and target ratio

eulerstack compile

Compile YAML spec -> IR -> runtime config (JSON) or HF model directory.

# Write JSON runtime config to file
eulerstack compile --preset my_model.yml --output compiled.json

# Build and save HF model directory (config.json + model.safetensors)
eulerstack compile --preset my_model.yml --output-dir ./my_model

# Print config to stdout
eulerstack compile --preset my_model.yml --print-config

# Dry run (alias for --print-config)
eulerstack compile --preset my_model.yml --dry-run

# Validate only, do not compile
eulerstack compile --preset my_model.yml --validate-only

--output-dir creates an HF-compatible model directory that can be loaded with:

from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("./my_model", trust_remote_code=True)

This is the primary way to create a model for training with eulerforge.

eulerstack schema

Print a summary of the YAML schema.

eulerstack schema

eulerstack presets Subcommands

eulerstack presets list

List all available presets with parameter estimates.

eulerstack presets list

eulerstack presets show <name>

Show detailed information about a specific preset.

eulerstack presets show llm_2b_simple

Error Format Policy

All CLI errors follow the 3-line format (eulerwa standard):

<Category>: <what>
Fix: <one line>
See: <doc path>

Error categories: - ValidationError — schema/structure violations - CompatibilityError — cross-field incompatibilities - CompileError — compilation failures - NormalizationError — IR normalization failures

Comparison with eulerforge (eulerwa CLI family)