How sakib75x/soup works
Soup is a CLI and Web UI for configuring, fine-tuning, evaluating, and serving LLMs, with data preparation, model export, and operational tooling. The documented primary workflow is to initialize a configuration, then train; the broader source tree also exposes ingestion, evaluation, deployment, recipe, and interoperability features. The graph preserves these major product areas, but many command implementations were not sampled, so their internal call paths are left unverified rather than inferred.
Main entry points: cli.py Soup CLI · app.py Web UI · train.py Training Command · ingest.py Trace Ingest
Components 22
Data Preparation
- Data Commands
src/soup_cli/commands/data.py - Trace Ingest
src/soup_cli/commands/ingest.py - Trace Adapters
src/soup_cli/utils/ingest_sources.py - Langfuse Pull
src/soup_cli/utils/ingest_pull.py - Dataset Loader
src/soup_cli/data/loader.py - Data Formats
src/soup_cli/data/formats.py
Training Runtime
- Configuration
src/soup_cli/config/schema.py - Training Command
src/soup_cli/commands/train.py - Trainer Dispatch
src/soup_cli/trainer/dispatch.py - Embedding Trainer
src/soup_cli/trainer/embedding.py - MoLE Trainer
src/soup_cli/trainer/mole_routing.py - Layer Streaming
src/soup_cli/utils/layer_stream.py
Model Operations
- Evaluation
src/soup_cli/eval - Recipe Catalog
src/soup_cli/recipes/catalog.py - Model Export
src/soup_cli/commands/export.py
Serving and Integration
- Model Serving
src/soup_cli/commands/serve.py - MCP Server
src/soup_cli/mcp_server/server.py - Webhook Delivery
src/soup_cli/utils/webhooks.py
Other components
- Engineer
- Langfuse
Connections 23
- Engineer → Soup CLI: runs commands
README.md - Soup CLI → Training Command: dispatches
src/soup_cli/cli.py - Soup CLI → Data Commands: dispatches
src/soup_cli/cli.py - Soup CLI → Model Serving: dispatches
src/soup_cli/cli.py - Soup CLI → Model Export: dispatches
src/soup_cli/cli.py - Engineer → Web UI: uses
README.md - Web UI → Configuration: lists templates
src/soup_cli/ui/app.py - Web UI → Dataset Loader: loads datasets
src/soup_cli/ui/app.py - Web UI → Recipe Catalog: reads recipes
src/soup_cli/ui/app.py - Trace Ingest → Trace Adapters: normalizes traces
src/soup_cli/commands/ingest.py - Trace Ingest → Langfuse Pull: pulls traces
src/soup_cli/commands/ingest.py - Langfuse Pull → Langfuse: requests generations
src/soup_cli/utils/ingest_pull.py - Dataset Loader → Data Formats: uses formats
src/soup_cli/data/loader.py - Training Command → Configuration: loads config
- Training Command → Dataset Loader: loads training data
- Training Command → Trainer Dispatch: starts training
- Trainer Dispatch → Embedding Trainer: selects task trainer
- Trainer Dispatch → MoLE Trainer: selects task trainer
- Embedding Trainer → Layer Streaming: uses streaming
src/soup_cli/trainer/embedding.py - Engineer → Evaluation: evaluates models
- Engineer → Recipe Catalog: browses recipes
- Engineer → MCP Server: connects tools
- Trace Ingest → Webhook Delivery: notifies optionally
src/soup_cli/commands/ingest.py