Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Unsupervised

Interactive data analysis CLI powered by Claude Code. Explore datasets, run queries, and generate reports from your terminal.

Install

curl -fsSL https://unsupervised.com/cli/install.sh | sh

This downloads the correct binary for your platform and installs it to ~/.local/bin/unsupervised. Set UNSUPERVISED_VERSION or UNSUPERVISED_INSTALL_DIR to customize.

Project setup

unsupervised install [dir]

Sets up a project directory with the standard folder structure (business_context/, datasources/, queries/, reports/, etc.), downloads required binaries, and configures Claude Code permissions.

Usage

unsupervised

Opens the CLI directly. Launches Claude Code in analyst mode with bundled configuration for data exploration, ad-hoc queries, and reporting.

unsupervised                       # start in current directory
unsupervised --role analyst        # explicit role (default)
unsupervised "summarize sales.csv" # pass a prompt directly

All unrecognized arguments are forwarded to Claude Code.

unsupervised web

Opens the web UI for browser-based interaction. Provides a file viewer, chat sidebar, and real-time workflow progress.

unsupervised web                   # start web UI → http://localhost:7070

unsupervised runner

Headless runner for automated pipelines (planned).

How it works

  1. Claude Code runs with a bundled analyst configuration (system prompt, permissions, plugins)
  2. DeepWork workflows coordinate multi-step analysis tasks
  3. Reports are written to reports/ in your project directory
  4. The web UI watches for file changes and updates in real time

Demos

End-to-end DeepWork demos live under demos/. Each demo is a self-contained CONTENT_DIR you can open with CONTENT_DIR=demos/<name> make up or by cd-ing into the folder and running the bundled CLI.

  • demos/oil/ — predict summer 2026 WTI crude oil prices by joining FRED price series, NOAA GHCN-Daily weather at oil-region stations, and GDELT geopolitical events on ISO-2 country code.

About

Unsupervised CLI

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages