Skip to content

Home

Jump to bottom
Giacomo Saccaggi edited this page Aug 27, 2026 · 13 revisions

scomp-link Wiki

Welcome to the scomp-link wiki — the end-to-end ML toolkit with 26 CLI commands, 41 chart types, 33 MCP tools, and native AI agent integration.

Navigation

Getting Started

Core Features

ML Components

Visualization & Reports

Integration

Reference

Quick Install

pip install scomp-link

Use as AI Tool (zero install)

Connect any MCP-compatible agent (Claude, Kiro, Cursor, VS Code) to the hosted server:

{"mcpServers": {"scomp-link": {"url": "https://Euribor512-scomp-link.hf.space/sse"}}}

Links
📦 PyPI pypi.org/project/scomp-link
🐙 GitHub github.com/GiacomoSaccaggi/scomp_link
🐳 Docker Hub hub.docker.com/r/jack15121/scomp-link
🤗 HF Space huggingface.co/spaces/Euribor512/scomp-link
🔧 Smithery smithery.ai/servers/giacomosaccaggi/scomp-link
📖 Docs giacomosaccaggi.github.io/scomp_link

What's New (v2.2.1)

  • CLI --version fix: now correctly reports runtime version (was hardcoded to 2.1.0)
  • 33 MCP tools (was 31)
  • Documentation: Full audit — all references updated to 33 tools

What's New (v2.2.1)

  • MCP SDK v2: Migrated from FastMCP to MCPServer (mcp>=2.0.0)
  • Mermaid.js Diagrams (report_add_mermaid / MermaidStep): flowcharts, sequence, gantt, class, state, ER, pie — client-side rendering
  • Terminal Replay (report_add_terminal / TerminalStep): embedded asciinema-player with themes, play/pause/seek
  • 33 MCP tools (was 29)
  • Pipeline DSL: New MermaidStep and TerminalStep
  • CDNs: Mermaid.js 11.4.0, asciinema-player 3.8.0

What's New (v2.2.1)

  • Code Blocks (report_add_code / CodeStep): Syntax-highlighted code with Prism.js, copy-to-clipboard, line numbers, collapsible, terminal-style output
  • Diff View (report_add_diff / DiffStep): Side-by-side GitHub-style diff with diff2html, red deletions / green additions, syntax highlighting
  • 31 MCP tools (was 27)
  • Pipeline DSL: New CodeStep and DiffStep for >> operator
  • Prism.js 1.29.0 + diff2html 3.4.48 (pinned CDN versions)

What's New (v2.2.1)

  • Report Builder — Interactive Components: add_kpi_cards, add_plotly_grid, add_tabs, add_cascading_content, add_comparison_table, add_summary_stats, add_dark_mode_toggle
  • add_dataframe() thresholds: conditional green/orange/red cell coloring
  • Plotly utilities: fill_timeslots, normalize_to_index, index_chart, stacked_area_comparison
  • Pipeline DSL (>> operator): Airflow-style declarative pipeline composition 
    # ML pipeline
(CleanStep(df) >> SelectStep("price") >> ModelStep("numerical_prediction") >> TrainStep("regression")).run()

# Report pipeline
(SectionStep("Results") >> TableStep(df, "Metrics") >> SaveStep("report.html")).run(report)
  • ML steps: CleanStep, SelectStep, ModelStep, TrainStep
  • Report steps: SectionStep, TitleStep, TextStep, GraphStep, TableStep, RawGraphStep, SaveStep
  • LogStep: transparent step to inspect intermediate pipeline state
  • Type safety: mixing ML and Report steps raises TypeError at >> time (not runtime)
  • pipeline >> step syntax: existing ScompLinkPipeline instance carried through the chain
  • Pyright 0 errors: strict typing enforced across the entire codebase (344 errors resolved)
  • 21 new tests in tests/test_pipeline_dsl.py

What's New (v2.2.1)

  • Contrastive Embedding System: EmbeddingSelector auto-selects the best pretrained backbone; fit_head() adds weak learner classifiers on frozen embeddings
  • Performance: FeatureEngineer migrated to Polars (3-10x faster); DriftDetector and DataQualityReport parallelized with ThreadPoolExecutor
  • CLI: New embed command for extracting embeddings; text command gains --head, --backbone, --select-backbone
  • MCP: 16 tools (added embed_text, select_backbone)
  • InfoNCELoss: Temperature-scaled NT-Xent loss for multi-class contrastive learning
  • HTML Reports: Contrastive classifier generates validation report with confusion matrix, per-class F1, t-SNE visualization
  • Coverage: 81% (tests + examples), 349+ tests, 36 examples all passing
  • Smithery: Published as MCPB bundle + remote URL

What's New (v2.2.1)

  • 🤗 Hugging Face Space — Remote MCP server (zero install)
  • 🔧 Smithery — Listed on the MCP registry
  • 🐳 Docker Hub — docker pull jack15121/scomp-link
  • Unified CI/CD — Single workflow for all publishing
  • 25 CLI commands with --format and --plot flags
  • MCP Server — 15 tools, 3 resources, 4 prompts
  • Agent Skill — SKILL.md for Claude/Kiro/Cursor/VS Code

Clone this wiki locally