Welcome to MDSA Framework

Multi-Domain Small Language Model Agentic Orchestration Framework

Installation Successful

Framework Features

🎯

Multi-Domain Routing

Automatically detect and route queries to specialized domains based on keywords and context.

🤖

LRU Model Caching

Intelligent model management with automatic eviction based on Least Recently Used (LRU) policy.

📊

Real-Time Monitoring

Comprehensive metrics and performance tracking with built-in dashboard.

🔧

Tool Integration

Extensible tool registry for function calling and external integrations.

📚

RAG Support

Built-in Retrieval-Augmented Generation with vector database integration.

High Performance

Optimized for speed with hardware detection and automatic GPU acceleration.

Quick Start

1. Basic Usage

from mdsa import ModelManager, DomainExecutor, DomainConfig

# Create model manager
manager = ModelManager(max_models=2)
executor = DomainExecutor(manager)

# Create domain
domain = DomainConfig(
    domain_id="general",
    name="General Assistant",
    description="General purpose assistant",
    keywords=["help", "question"],
    model_name="gpt2",  # Any HuggingFace model
    system_prompt="You are a helpful assistant"
)

# Execute query
result = executor.execute("What is AI?", domain)
print(result['response'])

2. With Monitoring

from mdsa import RequestLogger, MetricsCollector

# Create monitors
logger = RequestLogger(max_logs=10000)
metrics = MetricsCollector(window_size=1000)

# Log requests
logger.log_request(
    request_id="req_001",
    query="User query",
    domain="general",
    model="gpt2",
    response="Model response",
    status="success",
    latency_ms=150.5,
    tokens_generated=50,
    confidence=0.95
)

# Get statistics
stats = logger.get_stats()
summary = metrics.get_summary()
print(f"Total requests: {stats['total_requests']}")
print(f"Avg latency: {summary['avg_latency_ms']}ms")

3. Run Built-in Dashboard

from mdsa.ui.dashboard import DashboardServer

# Create dashboard with your components
server = DashboardServer(
    model_manager=manager,
    request_logger=logger,
    metrics_collector=metrics
)

# Run dashboard on http://127.0.0.1:5000
server.run()

# Or use CLI
# python -m mdsa.ui.dashboard

System Information

Framework Version
{{ version }}
Dashboard Status
Online
API Endpoint
/api/metrics
Documentation

Next Steps

1

Explore the Monitor

Visit the Monitor page to see real-time metrics, model performance, and request statistics.

2

Test the Framework

Create your own domains and execute queries to see the framework in action.

3

Integrate into Projects

Add MDSA to your applications for intelligent multi-domain LLM orchestration.