FrancyJGLisboa

SAFactory Hive Mind — Data skill for Claude Code

Data community

SAFactory is a meta-agent system that automatically generates perfect Single File Agents (SFAs) from real user data and intent.

How to install SAFactory Hive Mind

This entry records only its repository, not the path inside it, so there is no exact command to give. Open FrancyJGLisboa/SAFactory-Hive-Mind and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What SAFactory Hive Mind does

SAFactory is a meta-agent system that automatically generates perfect Single File Agents (SFAs) from real user data and intent.

Alternatives in Data

Data Contract — This document defines which files belong to the system (auto-updatable) and which belong to the user (never to 32.5k ★
User Segmentation — Segment users by behavior, JTBD, and needs from feedback data 7.8k ★
Context Mode — Benchmark Results — Benchmarked against real outputs from popular Claude Code MCP servers, Skills, and dev tools 5.6k ★

README

SAFactory Hive Mind 🏭🧠

**Transform any data into laser-focused Single File Agents using AI orchestration**

SAFactory Hive Mind generates self-contained Python scripts (Single File Agents) that analyze your data according to your specific intent. Each agent follows 10 invariant principles for reliability and consistency.

✨ Features

🎯 Intent-Driven Generation: Describe what you want, get a perfect agent
📊 Multi-Format Support: CSV, Excel (with formula detection), JSON, SQLite
🔧 Zero Dependencies: Agents run with just uv run
✅ Test-Before-Final: Built-in validation with success tokens
🎨 Modern Web Interface: Drag-and-drop file upload with live preview
🤖 Claude Integration: Powered by Claude 3.5 Sonnet

🚀 Quick Start

Option 1: Web Interface (Recommended for beginners)

Start the frontend:

cd frontend
npm install
npm run dev

**Open your browser** at http://localhost:3000
**Generate your agent**:
- Drag and drop your data file (CSV, Excel, JSON, or SQLite)
- Describe your intent (or click a sample)
- Click "Generate Agent"
- Download and run your agent

![SAFactory Web Interface](docs/images/web-interface.png)

Option 2: CLI (For power users)

Basic usage:

# Generate agent from CSV
bash scripts/safactory-hive-mind-final.sh --data sales.csv --output ./agents

# Generate with learning enabled
bash scripts/safactory-hive-mind-learning.sh --data report.xlsx --enable-learning

# Simple version for quick generation
bash scripts/safactory-hive-mind-simple.sh --data data.json

Run the generated agent:

# Install UV if needed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run your agent
uv run sfa_csv_20250820.py --data your_data.csv --compute 20

📁 Supported Data Types

Format	Features	Example Use Case
CSV	Column detection, statistics, pattern analysis	Sales data, time seri