# Table of Contents

This document outlines the structure of the model-compose user guide.

---

## 1. [Getting Started](./01-getting-started.md)
- 1.1 [Introduction and Overview](./01-getting-started.md#11-introduction-and-overview)
- 1.2 [Installation](./01-getting-started.md#12-installation)
- 1.3 [Running Your First Workflow](./01-getting-started.md#13-running-your-first-workflow)
  - 1.3.1 [Simple Example (OpenAI API Call)](./01-getting-started.md#131-simple-example-openai-api-call)
  - 1.3.2 [Running a Workflow (run command)](./01-getting-started.md#132-running-a-workflow-run-command)
  - 1.3.3 [Starting the Controller and Using Web UI](./01-getting-started.md#133-starting-the-controller-and-using-web-ui)
- 1.4 [Basic Concepts](./01-getting-started.md#14-basic-concepts)

## 2. [Core Concepts](./02-core-concepts.md)
- 2.1 [model-compose.yml Structure](./02-core-concepts.md#21-model-composeyml-structure)
- 2.2 [Controller](./02-core-concepts.md#22-controller)
- 2.3 [Components](./02-core-concepts.md#23-components)
- 2.4 [Workflows](./02-core-concepts.md#24-workflows)
- 2.5 [Jobs](./02-core-concepts.md#25-jobs)
- 2.6 [Data Flow and Variable Binding](./02-core-concepts.md#26-data-flow-and-variable-binding)

## 3. [CLI Usage](./03-cli-usage.md)
- 3.1 [Basic Commands](./03-cli-usage.md#31-basic-commands)
- 3.2 [up Command](./03-cli-usage.md#32-up-command)
- 3.3 [down Command](./03-cli-usage.md#33-down-command)
- 3.4 [start Command](./03-cli-usage.md#34-start-command)
- 3.5 [stop Command](./03-cli-usage.md#35-stop-command)
- 3.6 [run Command](./03-cli-usage.md#36-run-command)
- 3.7 [Environment Variable Management](./03-cli-usage.md#37-environment-variable-management)
- 3.8 [Configuration File Specification](./03-cli-usage.md#38-configuration-file-specification)
- 3.9 [Debugging Options](./03-cli-usage.md#39-debugging-options)
- 3.10 [Practical Examples](./03-cli-usage.md#310-practical-examples)
- 3.11 [Command Quick Reference](./03-cli-usage.md#311-command-quick-reference)

## 4. [Component Configuration](./04-component-configuration.md)
- 4.1 [Component Types](./04-component-configuration.md#41-component-types)
- 4.2 [Defining Components](./04-component-configuration.md#42-defining-components)
- 4.3 [Input/Output Mapping](./04-component-configuration.md#43-inputoutput-mapping)
- 4.4 [Reusability Patterns](./04-component-configuration.md#44-reusability-patterns)
- 4.5 [Component Best Practices](./04-component-configuration.md#45-component-best-practices)

## 5. [Writing Workflows](./05-writing-workflows.md)
- 5.1 [What is a Workflow?](./05-writing-workflows.md#51-what-is-a-workflow)
- 5.2 [Single-Job Workflows](./05-writing-workflows.md#52-single-job-workflows)
- 5.3 [Multi-Step Workflows](./05-writing-workflows.md#53-multi-step-workflows)
- 5.4 [Data Passing Between Jobs](./05-writing-workflows.md#54-data-passing-between-jobs)
- 5.5 [Job Types](./05-writing-workflows.md#55-job-types)
- 5.6 [Conditional Execution](./05-writing-workflows.md#56-conditional-execution)
- 5.7 [Streaming Mode](./05-writing-workflows.md#57-streaming-mode)
- 5.8 [Error Handling](./05-writing-workflows.md#58-error-handling)
- 5.9 [Workflow Best Practices](./05-writing-workflows.md#59-workflow-best-practices)

## 6. [Workflow Schema](./06-workflow-schema.md)
- 6.1 [What is a Workflow Schema?](./06-workflow-schema.md#61-what-is-a-workflow-schema)
- 6.2 [Retrieving the Schema](./06-workflow-schema.md#62-retrieving-the-schema)
- 6.3 [Input Schema](./06-workflow-schema.md#63-input-schema)
- 6.4 [Output Schema](./06-workflow-schema.md#64-output-schema)
- 6.5 [Schema in Practice](./06-workflow-schema.md#65-schema-in-practice)
- 6.6 [Practical Examples](./06-workflow-schema.md#66-practical-examples)
- 6.7 [Workflow Metadata Fields](./06-workflow-schema.md#67-workflow-metadata-fields)
- 6.8 [Best Practices](./06-workflow-schema.md#68-best-practices)

## 7. [Controller Configuration](./07-controller-configuration.md)
- 7.1 [HTTP Server](./07-controller-configuration.md#71-http-server)
- 7.2 [MCP Server](./07-controller-configuration.md#72-mcp-server)
- 7.3 [Queue Subscriber](./07-controller-configuration.md#73-queue-subscriber)
- 7.4 [Queue Dispatch (Distributed Deployment)](./07-controller-configuration.md#74-queue-dispatch-distributed-deployment)
- 7.5 [Queue Streaming](./07-controller-configuration.md#75-queue-streaming)
- 7.6 [Concurrency Control](./07-controller-configuration.md#76-concurrency-control)
- 7.7 [Port and Host Configuration](./07-controller-configuration.md#77-port-and-host-configuration)
- 7.8 [Controller Best Practices](./07-controller-configuration.md#78-controller-best-practices)

## 8. [WebSocket Interface](./08-websocket-interface.md)
- 8.1 [WebSocket Overview](./08-websocket-interface.md#81-websocket-overview)
  - 8.1.1 [What is the WebSocket Interface?](./08-websocket-interface.md#811-what-is-the-websocket-interface)
  - 8.1.2 [WebSocket vs REST API](./08-websocket-interface.md#812-websocket-vs-rest-api)
  - 8.1.3 [How It Works](./08-websocket-interface.md#813-how-it-works)
- 8.2 [Configuration](./08-websocket-interface.md#82-configuration)
  - 8.2.1 [Enabling WebSocket](./08-websocket-interface.md#821-enabling-websocket)
  - 8.2.2 [WebSocket Configuration Options](./08-websocket-interface.md#822-websocket-configuration-options)
  - 8.2.3 [Configuration Examples](./08-websocket-interface.md#823-configuration-examples)
- 8.3 [Connecting to WebSocket](./08-websocket-interface.md#83-connecting-to-websocket)
  - 8.3.1 [Basic Connection](./08-websocket-interface.md#831-basic-connection)
  - 8.3.2 [Session ID](./08-websocket-interface.md#832-session-id)
  - 8.3.3 [Auto-Subscribe on Connect](./08-websocket-interface.md#833-auto-subscribe-on-connect)
- 8.4 [WebSocket Messages](./08-websocket-interface.md#84-websocket-messages)
  - 8.4.1 [Message Format](./08-websocket-interface.md#841-message-format)
  - 8.4.2 [Client → Server Messages](./08-websocket-interface.md#842-client--server-messages)
  - 8.4.3 [Server → Client Messages](./08-websocket-interface.md#843-server--client-messages)
- 8.5 [REST API Integration](./08-websocket-interface.md#85-rest-api-integration)
  - 8.5.1 [`subscribe_task` Parameter](./08-websocket-interface.md#851-subscribe_task-parameter)
  - 8.5.2 [`wait_for_completion` and `subscribe_task` Combinations](./08-websocket-interface.md#852-wait_for_completion-and-subscribe_task-combinations)
  - 8.5.3 [Pattern: WebSocket First + REST Execution](./08-websocket-interface.md#853-pattern-websocket-first--rest-execution)
- 8.6 [Usage Patterns](./08-websocket-interface.md#86-usage-patterns)
  - 8.6.1 [Pattern 1: Execute and Monitor via WebSocket](./08-websocket-interface.md#861-pattern-1-execute-and-monitor-via-websocket)
  - 8.6.2 [Pattern 2: Interactive Interrupt/Resume](./08-websocket-interface.md#862-pattern-2-interactive-interruptresume)
  - 8.6.3 [Pattern 3: Subscribe to Existing Task](./08-websocket-interface.md#863-pattern-3-subscribe-to-existing-task)
  - 8.6.4 [Pattern 4: Multi-Task Dashboard](./08-websocket-interface.md#864-pattern-4-multi-task-dashboard)
- 8.7 [Connection Management](./08-websocket-interface.md#87-connection-management)
  - 8.7.1 [Session and Reconnection](./08-websocket-interface.md#871-session-and-reconnection)
  - 8.7.2 [Connection Lifecycle](./08-websocket-interface.md#872-connection-lifecycle)
  - 8.7.3 [Connection Limits](./08-websocket-interface.md#873-connection-limits)
  - 8.7.4 [Keep-Alive with Ping](./08-websocket-interface.md#874-keep-alive-with-ping)
- 8.8 [Security Considerations](./08-websocket-interface.md#88-security-considerations)
  - 8.8.1 [Session ID Security](./08-websocket-interface.md#881-session-id-security)
  - 8.8.2 [CORS and Origins](./08-websocket-interface.md#882-cors-and-origins)
  - 8.8.3 [Production Recommendations](./08-websocket-interface.md#883-production-recommendations)
- 8.9 [Best Practices](./08-websocket-interface.md#89-best-practices)

## 9. [Web UI Configuration](./09-webui-configuration.md)
- 9.1 [Web UI Overview](./09-webui-configuration.md#91-web-ui-overview)
- 9.2 [Gradio Driver](./09-webui-configuration.md#92-gradio-driver)
- 9.3 [Static File Driver](./09-webui-configuration.md#93-static-file-driver)
- 9.4 [Web UI Deployment via Reverse Proxy](./09-webui-configuration.md#94-web-ui-deployment-via-reverse-proxy)

## 10. [Working with Local AI Models](./10-local-ai-models.md)
- 10.1 [Local Model Overview](./10-local-ai-models.md#101-local-model-overview)
- 10.2 [Model Installation and Setup](./10-local-ai-models.md#102-model-installation-and-setup)
- 10.3 [Supported Task Types](./10-local-ai-models.md#103-supported-task-types)
- 10.4 [Model Configuration (Device, Precision, Batch Size)](./10-local-ai-models.md#104-model-configuration-device-precision-batch-size)
- 10.5 [Using LoRA/PEFT Adapters](./10-local-ai-models.md#105-using-lorapeft-adapters)
- 10.6 [Model Serving Frameworks](./10-local-ai-models.md#106-model-serving-frameworks)
- 10.7 [Performance Optimization Tips](./10-local-ai-models.md#107-performance-optimization-tips)

## 11. [Model Training](./11-model-training.md)
- 11.1 [Training Overview](./11-model-training.md#111-training-overview)
- 11.2 [Dataset Preparation](./11-model-training.md#112-dataset-preparation)
  - 11.2.1 [Dataset Component Overview](./11-model-training.md#1121-dataset-component-overview)
  - 11.2.2 [Loading HuggingFace Datasets](./11-model-training.md#1122-loading-huggingface-datasets)
  - 11.2.3 [Loading Local Datasets](./11-model-training.md#1123-loading-local-datasets)
  - 11.2.4 [Dataset Manipulation](./11-model-training.md#1124-dataset-manipulation)
  - 11.2.5 [Dataset Formats](./11-model-training.md#1125-dataset-formats)
- 11.3 [Training Configuration](./11-model-training.md#113-training-configuration)
  - 11.3.1 [Basic Training Configuration](./11-model-training.md#1131-basic-training-configuration)
  - 11.3.2 [Optimizer Configuration](./11-model-training.md#1132-optimizer-configuration)
  - 11.3.3 [Learning Rate Scheduler](./11-model-training.md#1133-learning-rate-scheduler)
  - 11.3.4 [Optimization Settings](./11-model-training.md#1134-optimization-settings)
  - 11.3.5 [Evaluation and Saving](./11-model-training.md#1135-evaluation-and-saving)
  - 11.3.6 [Memory Optimization](./11-model-training.md#1136-memory-optimization)
  - 11.3.7 [Reproducibility Settings](./11-model-training.md#1137-reproducibility-settings)
- 11.4 [Fine-tuning](./11-model-training.md#114-fine-tuning)
  - 11.4.1 [SFT (Supervised Fine-Tuning)](./11-model-training.md#1141-sft-supervised-fine-tuning)
  - 11.4.2 [Sequence Packing](./11-model-training.md#1142-sequence-packing)
- 11.5 [LoRA Training](./11-model-training.md#115-lora-training)
  - 11.5.1 [LoRA Overview](./11-model-training.md#1151-lora-overview)
  - 11.5.2 [Basic LoRA Configuration](./11-model-training.md#1152-basic-lora-configuration)
  - 11.5.3 [Target Module Configuration](./11-model-training.md#1153-target-module-configuration)
  - 11.5.4 [LoRA Bias Configuration](./11-model-training.md#1154-lora-bias-configuration)
  - 11.5.5 [QLoRA (Quantized LoRA)](./11-model-training.md#1155-qlora-quantized-lora)
  - 11.5.6 [LoRA Hyperparameter Guide](./11-model-training.md#1156-lora-hyperparameter-guide)
- 11.6 [Training Monitoring](./11-model-training.md#116-training-monitoring)
- 11.7 [Checkpoint Management](./11-model-training.md#117-checkpoint-management)
- 11.8 [Practical Examples](./11-model-training.md#118-practical-examples)

## 12. [External Service Integration](./12-external-service-integration.md)
- 12.1 [OpenAI API](./12-external-service-integration.md#121-openai-api)
  - 12.1.1 [Chat Completions](./12-external-service-integration.md#1211-chat-completions)
  - 12.1.2 [Image Generation (DALL-E)](./12-external-service-integration.md#1212-image-generation-dall-e)
  - 12.1.3 [Audio (TTS, Transcriptions)](./12-external-service-integration.md#1213-audio-tts-transcriptions)
- 12.2 [Anthropic Claude API](./12-external-service-integration.md#122-anthropic-claude-api)
- 12.3 [Google Gemini API](./12-external-service-integration.md#123-google-gemini-api)
- 12.4 [ElevenLabs (TTS)](./12-external-service-integration.md#124-elevenlabs-tts)
- 12.5 [Stability AI (Image Generation)](./12-external-service-integration.md#125-stability-ai-image-generation)
- 12.6 [Replicate](./12-external-service-integration.md#126-replicate)
- 12.7 [Custom HTTP API](./12-external-service-integration.md#127-custom-http-api)
- 12.8 [External Service Integration Best Practices](./12-external-service-integration.md#128-external-service-integration-best-practices)

## 13. [Streaming Mode](./13-streaming-mode.md)
- 13.1 [Streaming Overview](./13-streaming-mode.md#131-streaming-overview)
  - 13.1.1 [What is Streaming?](./13-streaming-mode.md#1311-what-is-streaming)
  - 13.1.2 [Supported Components](./13-streaming-mode.md#1312-supported-components)
  - 13.1.3 [Streaming Protocol](./13-streaming-mode.md#1313-streaming-protocol)
- 13.2 [Component-Specific Streaming Configuration](./13-streaming-mode.md#132-component-specific-streaming-configuration)
  - 13.2.1 [Model Components](./13-streaming-mode.md#1321-model-components)
  - 13.2.2 [HTTP Components](./13-streaming-mode.md#1322-http-components)
- 13.3 [Using Streaming in Workflows](./13-streaming-mode.md#133-using-streaming-in-workflows)
  - 13.3.1 [Basic Streaming Workflow](./13-streaming-mode.md#1331-basic-streaming-workflow)
  - 13.3.2 [Multi-Step Workflow Streaming](./13-streaming-mode.md#1332-multi-step-workflow-streaming)
  - 13.3.3 [Conditional Streaming](./13-streaming-mode.md#1333-conditional-streaming)
- 13.4 [Processing Streaming Responses](./13-streaming-mode.md#134-processing-streaming-responses)
  - 13.4.1 [API Endpoints](./13-streaming-mode.md#1341-api-endpoints)
  - 13.4.2 [Client Implementation (JavaScript)](./13-streaming-mode.md#1342-client-implementation-javascript)
  - 13.4.3 [Client Implementation (Python)](./13-streaming-mode.md#1343-client-implementation-python)
  - 13.4.4 [Web UI Integration](./13-streaming-mode.md#1344-web-ui-integration)
- 13.5 [Performance and Optimization](./13-streaming-mode.md#135-performance-and-optimization)
  - 13.5.1 [Model Streaming Optimization](./13-streaming-mode.md#1351-model-streaming-optimization)
  - 13.5.2 [HTTP Streaming Optimization](./13-streaming-mode.md#1352-http-streaming-optimization)
  - 13.5.3 [Memory Management](./13-streaming-mode.md#1353-memory-management)
  - 13.5.4 [Network Optimization](./13-streaming-mode.md#1354-network-optimization)
  - 13.5.5 [Error Handling](./13-streaming-mode.md#1355-error-handling)
- 13.6 [Real-World Examples](./13-streaming-mode.md#136-real-world-examples)
  - 13.6.1 [Real-time Translation Streaming](./13-streaming-mode.md#1361-real-time-translation-streaming)
  - 13.6.2 [OpenAI + Claude Combination](./13-streaming-mode.md#1362-openai--claude-combination)
  - 13.6.3 [Local Model Streaming Server](./13-streaming-mode.md#1363-local-model-streaming-server)
- 13.7 [Distributed Streaming (Queue Streaming)](./13-streaming-mode.md#137-distributed-streaming-queue-streaming)
- 13.8 [Streaming Best Practices](./13-streaming-mode.md#138-streaming-best-practices)

## 14. [Variable Binding](./14-variable-binding.md)
- 14.1 [Syntax Overview](./14-variable-binding.md#141-syntax-overview)
- 14.2 [Variable Sources](./14-variable-binding.md#142-variable-sources)
  - 14.2.1 [Workflow Input](./14-variable-binding.md#1421-workflow-input)
  - 14.2.2 [Component Response Variables](./14-variable-binding.md#1422-component-response-variables)
  - 14.2.3 [Previous Job Outputs](./14-variable-binding.md#1423-previous-job-outputs)
  - 14.2.4 [Environment Variables](./14-variable-binding.md#1424-environment-variables)
  - 14.2.5 [Streaming Chunk References](./14-variable-binding.md#1425-streaming-chunk-references)
- 14.3 [Path Access](./14-variable-binding.md#143-path-access)
- 14.4 [Type Conversion](./14-variable-binding.md#144-type-conversion)
  - 14.4.1 [Primitive Types](./14-variable-binding.md#1441-primitive-types)
  - 14.4.2 [Object Array Projection](./14-variable-binding.md#1442-object-array-projection)
  - 14.4.3 [Media Types](./14-variable-binding.md#1443-media-types)
  - 14.4.4 [Attributes](./14-variable-binding.md#1444-attributes)
  - 14.4.5 [Base64 Type vs Base64 Format](./14-variable-binding.md#1445-base64-type-vs-base64-format)
- 14.5 [Format and Context Semantics](./14-variable-binding.md#145-format-and-context-semantics)
  - 14.5.1 [Format Values](./14-variable-binding.md#1451-format-values)
  - 14.5.2 [Input Context](./14-variable-binding.md#1452-input-context)
  - 14.5.3 [Component/Job Output Context](./14-variable-binding.md#1453-componentjob-output-context)
  - 14.5.4 [Workflow Output Context](./14-variable-binding.md#1454-workflow-output-context)
- 14.6 [Default Values](./14-variable-binding.md#146-default-values)
  - 14.6.1 [Literal Default Values](./14-variable-binding.md#1461-literal-default-values)
  - 14.6.2 [Environment Variable Default Values](./14-variable-binding.md#1462-environment-variable-default-values)
  - 14.6.3 [Nested Default Values](./14-variable-binding.md#1463-nested-default-values-environment-variable--literal)
- 14.7 [Metadata and UI Hints](./14-variable-binding.md#147-metadata-and-ui-hints)
  - 14.7.1 [Annotations](./14-variable-binding.md#1471-annotations)
  - 14.7.2 [Select (Dropdown)](./14-variable-binding.md#1472-select-dropdown)
  - 14.7.3 [Slider](./14-variable-binding.md#1473-slider)
  - 14.7.4 [Textarea](./14-variable-binding.md#1474-textarea)
- 14.8 [Practical Examples](./14-variable-binding.md#148-practical-examples)

## 15. [System Integration](./15-system-integration.md)
- 15.1 [Listener Overview](./15-system-integration.md#151-listener-overview)
- 15.2 [HTTP Callback Listener](./15-system-integration.md#152-http-callback-listener)
  - 15.2.1 [HTTP Callback Overview](./15-system-integration.md#1521-http-callback-overview)
  - 15.2.2 [Basic HTTP Callback Configuration](./15-system-integration.md#1522-basic-http-callback-configuration)
  - 15.2.3 [Callback Endpoint Configuration](./15-system-integration.md#1523-callback-endpoint-configuration)
  - 15.2.4 [Callback Field Descriptions](./15-system-integration.md#1524-callback-field-descriptions)
  - 15.2.5 [Bulk Callback Processing](./15-system-integration.md#1525-bulk-callback-processing)
  - 15.2.6 [Advanced HTTP Callback Configuration](./15-system-integration.md#1526-advanced-http-callback-configuration)
  - 15.2.7 [How HTTP Callback Works](./15-system-integration.md#1527-how-http-callback-works)
  - 15.2.8 [Callback Data Mapping](./15-system-integration.md#1528-callback-data-mapping)
- 15.3 [HTTP Trigger Listener](./15-system-integration.md#153-http-trigger-listener)
  - 15.3.1 [HTTP Trigger Overview](./15-system-integration.md#1531-http-trigger-overview)
  - 15.3.2 [Basic HTTP Trigger Configuration](./15-system-integration.md#1532-basic-http-trigger-configuration)
  - 15.3.3 [Trigger Endpoint Configuration](./15-system-integration.md#1533-trigger-endpoint-configuration)
  - 15.3.4 [Trigger Field Descriptions](./15-system-integration.md#1534-trigger-field-descriptions)
  - 15.3.5 [Bulk Trigger Processing](./15-system-integration.md#1535-bulk-trigger-processing)
  - 15.3.6 [How HTTP Trigger Works](./15-system-integration.md#1536-how-http-trigger-works)
  - 15.3.7 [Input Data Mapping](./15-system-integration.md#1537-input-data-mapping)
  - 15.3.8 [Practical Examples](./15-system-integration.md#1538-practical-examples)
- 15.4 [Gateways - HTTP Tunneling](./15-system-integration.md#154-gateways---http-tunneling)
  - 15.4.1 [Gateway Overview](./15-system-integration.md#1541-gateway-overview)
  - 15.4.2 [HTTP Tunnel - ngrok](./15-system-integration.md#1542-http-tunnel---ngrok)
  - 15.4.3 [HTTP Tunnel - Cloudflare](./15-system-integration.md#1543-http-tunnel---cloudflare)
  - 15.4.4 [SSH Tunnel](./15-system-integration.md#1544-ssh-tunnel)
  - 15.4.5 [Advanced Gateway Configuration](./15-system-integration.md#1545-advanced-gateway-configuration)
  - 15.4.6 [Real-world Example: Slack Bot Webhook](./15-system-integration.md#1546-real-world-example-slack-bot-webhook)
- 15.5 [Using Listeners and Gateways Together](./15-system-integration.md#155-using-listeners-and-gateways-together)
  - 15.5.1 [Integration Example: Async Image Processing](./15-system-integration.md#1551-integration-example-async-image-processing)
  - 15.5.2 [Architecture Diagram](./15-system-integration.md#1552-architecture-diagram)
  - 15.5.3 [Production Environment Considerations](./15-system-integration.md#1553-production-environment-considerations)
- 15.6 [System Integration Best Practices](./15-system-integration.md#156-system-integration-best-practices)
- 15.7 [Systems - Infrastructure Management](./15-system-integration.md#157-systems---infrastructure-management)
  - 15.7.1 [Systems Overview](./15-system-integration.md#1571-systems-overview)
  - 15.7.2 [Docker Compose System](./15-system-integration.md#1572-docker-compose-system)
  - 15.7.3 [Multiple Systems](./15-system-integration.md#1573-multiple-systems)
  - 15.7.4 [Complete Example: Browser Automation](./15-system-integration.md#1574-complete-example-browser-automation)
  - 15.7.5 [Lifecycle Order](./15-system-integration.md#1575-lifecycle-order)
  - 15.7.6 [Prerequisites](./15-system-integration.md#1576-prerequisites)

## 16. [Deployment](./16-deployment.md)
- 16.1 [Local Execution](./16-deployment.md#161-local-execution)
  - 16.1.1 [Basic Execution](./16-deployment.md#1611-basic-execution)
  - 16.1.2 [Environment Variable Management](./16-deployment.md#1612-environment-variable-management)
  - 16.1.3 [Specifying Configuration File](./16-deployment.md#1613-specifying-configuration-file)
  - 16.1.4 [Running Workflow Standalone](./16-deployment.md#1614-running-workflow-standalone)
  - 16.1.5 [Debugging Options](./16-deployment.md#1615-debugging-options)
- 16.2 [Docker Runtime](./16-deployment.md#162-docker-runtime)
  - 16.2.1 [Basic Docker Configuration](./16-deployment.md#1621-basic-docker-configuration)
  - 16.2.2 [Advanced Docker Options](./16-deployment.md#1622-advanced-docker-options)
  - 16.2.3 [Volumes and Environment Variables](./16-deployment.md#1623-volumes-and-environment-variables)
- 16.3 [Docker Container Build and Deployment](./16-deployment.md#163-docker-container-build-and-deployment)
  - 16.3.1 [Automatic Build Process](./16-deployment.md#1631-automatic-build-process)
  - 16.3.2 [Using Custom Dockerfile](./16-deployment.md#1632-using-custom-dockerfile)
  - 16.3.3 [Multi-stage Build](./16-deployment.md#1633-multi-stage-build)
  - 16.3.4 [Using Image Registry](./16-deployment.md#1634-using-image-registry)
  - 16.3.5 [Private Registry Authentication](./16-deployment.md#1635-private-registry-authentication)
- 16.4 [Production Environment Considerations](./16-deployment.md#164-production-environment-considerations)
  - 16.4.1 [Concurrency Control](./16-deployment.md#1641-concurrency-control)
  - 16.4.2 [Resource Limits](./16-deployment.md#1642-resource-limits)
  - 16.4.3 [Restart Policy](./16-deployment.md#1643-restart-policy)
  - 16.4.4 [Health Check](./16-deployment.md#1644-health-check)
  - 16.4.5 [Security Considerations](./16-deployment.md#1645-security-considerations)
  - 16.4.6 [Data Persistence](./16-deployment.md#1646-data-persistence)
- 16.5 [Monitoring and Logging](./16-deployment.md#165-monitoring-and-logging)
  - 16.5.1 [Logger Configuration](./16-deployment.md#1651-logger-configuration)
  - 16.5.2 [Docker Container Logs](./16-deployment.md#1652-docker-container-logs)
  - 16.5.3 [Workflow Execution Logging](./16-deployment.md#1653-workflow-execution-logging)
  - 16.5.4 [Metrics Collection](./16-deployment.md#1654-metrics-collection)
  - 16.5.5 [External Monitoring Systems](./16-deployment.md#1655-external-monitoring-systems)
  - 16.5.6 [Tracer Configuration](./16-deployment.md#1656-tracer-configuration)
- 16.6 [Deployment Best Practices](./16-deployment.md#166-deployment-best-practices)

## 17. [Practical Examples](./17-practical-examples.md)
- 17.1 [Building a Chatbot](./17-practical-examples.md#171-building-a-chatbot)
  - 17.1.1 [OpenAI GPT-4o Chatbot](./17-practical-examples.md#1711-openai-gpt-4o-chatbot)
  - 17.1.2 [Streaming Chatbot](./17-practical-examples.md#1712-streaming-chatbot)
- 17.2 [Voice Generation Pipeline](./17-practical-examples.md#172-voice-generation-pipeline)
  - 17.2.1 [Text-to-Speech (OpenAI TTS)](./17-practical-examples.md#1721-text-to-speech-openai-tts)
  - 17.2.2 [Inspiring Quote Voice Generation](./17-practical-examples.md#1722-inspiring-quote-voice-generation)
- 17.3 [Image Analysis and Editing](./17-practical-examples.md#173-image-analysis-and-editing)
  - 17.3.1 [Image Captioning (Image-to-Text)](./17-practical-examples.md#1731-image-captioning-image-to-text)
  - 17.3.2 [Image Editing (OpenAI DALL-E)](./17-practical-examples.md#1732-image-editing-openai-dall-e)
- 17.4 [RAG System (Using Vector DB)](./17-practical-examples.md#174-rag-system-using-vector-db)
  - 17.4.1 [Text Embedding Search with ChromaDB](./17-practical-examples.md#1741-text-embedding-search-with-chromadb)
  - 17.4.2 [RAG System with Milvus](./17-practical-examples.md#1742-rag-system-with-milvus)
- 17.5 [Slack Bot (MCP)](./17-practical-examples.md#175-slack-bot-mcp)
  - 17.5.1 [Building a Slack Bot with MCP Server](./17-practical-examples.md#1751-building-a-slack-bot-with-mcp-server)
  - 17.5.2 [AI-Powered Slack Auto-Reply Bot](./17-practical-examples.md#1752-ai-powered-slack-auto-reply-bot)
- 17.6 [Multimodal Workflows](./17-practical-examples.md#176-multimodal-workflows)
  - 17.6.1 [Image → Text → Speech Pipeline](./17-practical-examples.md#1761-image--text--speech-pipeline)
  - 17.6.2 [Speech → Text → Translation → Speech Pipeline](./17-practical-examples.md#1762-speech--text--translation--speech-pipeline)
- 17.7 [Browser Automation](./17-practical-examples.md#177-browser-automation)
  - 17.7.1 [Web Scraping with CAPTCHA Fallback](./17-practical-examples.md#1771-web-scraping-with-captcha-fallback)
  - 17.7.2 [Login and Scrape Protected Content](./17-practical-examples.md#1772-login-and-scrape-protected-content)
  - 17.7.3 [AI-Powered Web Content Analysis](./17-practical-examples.md#1773-ai-powered-web-content-analysis)
- 17.8 [Key-Value Store (Caching & Sessions)](./17-practical-examples.md#178-key-value-store-caching--sessions)
  - 17.8.1 [API Response Caching](./17-practical-examples.md#1781-api-response-caching)
  - 17.8.2 [Session Management](./17-practical-examples.md#1782-session-management)
- 17.9 [Graph Store (Knowledge Graphs & Social Networks)](./17-practical-examples.md#179-graph-store-knowledge-graphs--social-networks)
  - 17.9.1 [Knowledge Graph with Neo4j](./17-practical-examples.md#1791-knowledge-graph-with-neo4j)
  - 17.9.2 [Social Graph with ArangoDB](./17-practical-examples.md#1792-social-graph-with-arangodb)
- 17.10 [Chatbot with Conversation Memory](./17-practical-examples.md#1710-chatbot-with-conversation-memory)
  - 17.10.1 [Stateful Chatbot (model-memory)](./17-practical-examples.md#17101-stateful-chatbot-model-memory)
  - 17.10.2 [Multi-User Chat with Redis Memory](./17-practical-examples.md#17102-multi-user-chat-with-redis-memory)

## 18. [Troubleshooting](./18-troubleshooting.md)
- 18.1 [Frequently Asked Questions (FAQ)](./18-troubleshooting.md#181-frequently-asked-questions-faq)
  - 18.1.1 [Installation and Environment Setup](./18-troubleshooting.md#1811-installation-and-environment-setup)
  - 18.1.2 [Component Configuration](./18-troubleshooting.md#1812-component-configuration)
  - 18.1.3 [Workflow Execution](./18-troubleshooting.md#1813-workflow-execution)
  - 18.1.4 [Web UI](./18-troubleshooting.md#1814-web-ui)
  - 18.1.5 [Listeners and Gateways](./18-troubleshooting.md#1815-listeners-and-gateways)
- 18.2 [Common Errors and Solutions](./18-troubleshooting.md#182-common-errors-and-solutions)
  - 18.2.1 [Model Loading Errors](./18-troubleshooting.md#1821-model-loading-errors)
  - 18.2.2 [Network Errors](./18-troubleshooting.md#1822-network-errors)
  - 18.2.3 [Configuration File Errors](./18-troubleshooting.md#1823-configuration-file-errors)
  - 18.2.4 [Variable Binding Errors](./18-troubleshooting.md#1824-variable-binding-errors)
  - 18.2.5 [Docker Runtime Errors](./18-troubleshooting.md#1825-docker-runtime-errors)
- 18.3 [Debugging Tips](./18-troubleshooting.md#183-debugging-tips)
  - 18.3.1 [Enable Logging](./18-troubleshooting.md#1831-enable-logging)
  - 18.3.2 [Check Variable Values](./18-troubleshooting.md#1832-check-variable-values)
  - 18.3.3 [Step-by-Step Execution](./18-troubleshooting.md#1833-step-by-step-execution)
  - 18.3.4 [Check API Responses](./18-troubleshooting.md#1834-check-api-responses)
  - 18.3.5 [Docker Container Logs](./18-troubleshooting.md#1835-docker-container-logs)
  - 18.3.6 [Verify Environment Variables](./18-troubleshooting.md#1836-verify-environment-variables)
  - 18.3.7 [Check Port Conflicts](./18-troubleshooting.md#1837-check-port-conflicts)
  - 18.3.8 [Verify Dependencies](./18-troubleshooting.md#1838-verify-dependencies)

## 19. [Appendix](./19-appendix.md)
- 19.1 [Complete Configuration File Schema](./19-appendix.md#191-complete-configuration-file-schema)
  - 19.1.1 [Top-Level Structure](./19-appendix.md#1911-top-level-structure)
  - 19.1.2 [Controller Schema](./19-appendix.md#1912-controller-schema)
  - 19.1.3 [Component Schema](./19-appendix.md#1913-component-schema)
  - 19.1.4 [Workflow Schema](./19-appendix.md#1914-workflow-schema)
  - 19.1.5 [Listener Schema](./19-appendix.md#1915-listener-schema)
  - 19.1.6 [Gateway Schema](./19-appendix.md#1916-gateway-schema)
  - 19.1.7 [Logger Schema](./19-appendix.md#1917-logger-schema)
  - 19.1.8 [Tracer Schema](./19-appendix.md#1918-tracer-schema)
  - 19.1.9 [Runtime Schema](./19-appendix.md#1919-runtime-schema)

---

**Note**: Sections marked with "TBD" are placeholders for features currently under development.
