.. _user_guide:

==========
User Guide
==========

Everything you need to use Pulsar effectively—from seeing it in action to production pipelines.

Demos & Use Cases
-----------------

See Pulsar discover real structure in real data:

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`zap` Real Demos
      :link: demos
      :link-type: ref
      :class-card: intro-card
      :shadow: md

      Five runnable projects: penguins, MMLU, clinical data, ECG, coal plants.

   .. grid-item-card:: :octicon:`star` Why Pulsar?
      :link: why_pulsar
      :link-type: ref
      :class-card: intro-card
      :shadow: md

      When topological analysis beats traditional clustering. Decision tree.


AI Tools & Automation
---------------------

Use Pulsar with Claude, Gemini, or Cursor—no code required:

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`hubot` MCP Server & Agents
      :link: userGuides/mcp
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Use Pulsar via Claude Desktop, Gemini CLI, Claude Code, Cursor, and Windsurf.

Pipeline Configuration & Tuning
-------------------------------

Understand parameters and customize your sweeps:

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`tools` Tuning Guide
      :link: userGuides/intermediate
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Pulsar supported parameters and configuration options.

   .. grid-item-card:: :octicon:`tools` Programmatic Control
      :link: userGuides/programmatic
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Full control over the pipeline with the Python API.