Skip to content

🔍 CRISP-T (Sense-making from Text and Numbers!)

Release Build status codecov Commit activity License Downloads

Generated by github-dependents-info Wiki Documentation

✨ Have you been co-creating reality with adaptive AI vibes?

TL;DR CRISP-T is a qualitative research method and a toolkit to perform mixed data (text + numeric) analytics for computational triangulation and sense-making. More importantly, CRISP brings "vibe analytics" "SKILLS" for mixed data with an AI agent, adopting an adaptive epistomology.

✨ Download this or a similar dataset, clone this repo, and try a prompt like 👇 in your vibe analytics platform.

Import the csv file from ./downloads folder using the crisp-cli skill with “review” as the text column. Do a comprehensive analysis, integrating both its numeric and textual features, and show the key patterns, relationships, and insights that emerge.

  • MCP SERVER will give more agentic power to your vibe analytics experience (See below).
  • Interpretivist approach: CRISP-T enforces the agentic researcher to adopt an interpretivist approach, rather than a data-science one.

😎 UI using GitHub Copilot SDK - Work in progress!

  • Set up copilot sdk
  • crisp-ui
  • Access the UI at http://127.0.0.1:5000/

👉 CLI Cheatsheet | Demo & Examples | Documentation

Give us a star ⭐️ if you find this useful!

📖 Introduction

Qualitative research focuses on collecting and analyzing textual data to explore complex phenomena. While qualitative and quantitative data are often used together, there is no standard method for combining them.

CRISP-T integrates textual data (interview transcripts, field notes) and numeric data (surveys, demographics) into a unified corpus. It allows researchers to: - Perform INDUCTIVE analysis (finding patterns). - Triangulate findings by linking text topics to numeric trends. - Use Semantic Search to find relevant literature or code documents. - Leverage GenAI through our MCP server for agentic analysis.

Key Features

  • ✅ No Python knowledge required - Full CLI support.
  • ✅ Interpretivist approach - Designed for sense-making, not just data science.
  • ✅ GenAI Ready - Augments LLMs with agentic tools.
  • ✅ Open Source - GPL-3.0 License.

The CRISP tools may also be useful for:

  • ⭕ Automated interview coding dictionary generation.
  • ⭕ Semantically filtering journal articles for literature review.
  • ⭕ Generating visualizations for qualitative (e.g. word cloud) and quantitative (e.g. TDABM) data.
  • ⭕ Many other ….

CRISP is ❌ NOT for:

  • ❌ Multimodal prediction. Use this instead!
  • ❌ Sequential mixed methods research, where qualitative and quantitative data are collected and analyzed in separate phases.
  • ❌ Convergent parallel mixed method designs where qualitative and quantitative data are collected simultaneously but analyzed separately.

💻 Installation

pip install crisp-t

Recommended (for Machine Learning features):

pip install crisp-t[ml]

Optional (for XGBoost):

pip install crisp-t[xg]
# Mac users: brew install libomp

Optional (for Web UI with Copilot SDK):

pip install crisp-t[copilot]
# Also requires GitHub Copilot CLI: https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli

🚀 Usage

CRISP-T provides three main CLI tools. See the CLI Cheatsheet for a full list of commands.

1. crisp (Analysis)

The main tool for data import and analysis.

  • Import Data: crisp --source ./data --out ./corpus
  • Analyze Text: crisp --inp ./corpus --topics --sentiment
  • Analyze Numbers: crisp --inp ./corpus --kmeans --regression

2. crispviz (Visualization)

Generates charts and graphs from your analysis.

  • Word Cloud: crispviz --inp ./corpus --wordcloud --out ./viz
  • Interactive Topics: crispviz --inp ./corpus --ldavis --out ./viz

3. crispt (Corpus Toolkit)

Manages corpus structure and detailed queries.

  • Semantic Search: crispt --inp ./corpus --semantic "query" --num 5
  • Metadata: crispt --inp ./corpus --meta "project=phase1"

4. crisp-ui (Web UI - NEW!)

Browser-based interface powered by GitHub Copilot SDK.

  • Start Web Server: crisp-ui
  • Custom Port: crisp-ui --port 8080
  • Open browser to: http://127.0.0.1:5000

The Web UI provides a conversational AI interface for CRISP-T, allowing you to: - Interact with CRISP-T through natural language - Execute CLI commands through an AI assistant - Visualize results in real-time - Choose from multiple AI models (GPT-5, Claude, etc.) - Use local models via Ollama or custom providers

📖 See Web UI Documentation for detailed instructions.

👉 View the Step-by-Step Demo

🤖 MCP Server (Agentic AI)

CRISP-T includes a Model Context Protocol (MCP) server, allowing AI agents (like Claude Desktop) to interact directly with your data. If you have opened this repository in VSCODE or AntiGravity, you can start the MCP server using the configuration file provided. This configuration file provides the necessary details for configuring other AI coding platforms such as Claude Desktop to connect to the CRISP-T MCP server as well.

🤖 Skills (Agentic AI)

CRISP-T also provides Skills for use with Claude Desktop, AntiGravity, VSCODE and other AI coding platforms.

Data model

crisp-t

📚 Documentation & References

🤝 Contribution & Contact

First presented at ICIS 2025.