flow

---
summary: Intelligent skill orchestrator that compiles natural language requests into secure, reusable workflows
tags:
  - automation
  - workflow
  - nlp
  - security
  - orchestration
  - skill-builder
  - clawdbot
  - mcp
---

# Flow

Intelligent Skill Orchestrator for Clawdbot/MCP - compose natural language requests into secure, reusable FLOW skills.

## Capabilities

- Parse natural language build requests
- Search skill registry for reusable components
- Security scan all skills before composition
- Compile multiple skills into unified FLOW
- Track skill usage for intelligent reuse
- Dependency resolution with topological sorting

## How It Works

1. **Natural Language Input**: Describe what you want to build
2. **Intent Parsing**: Extract capabilities, tags, and execution steps
3. **Registry Search**: Find existing skills that match requirements
4. **Security Scan**: Check all components for malicious patterns
5. **Composition**: Merge skills into single executable FLOW
6. **Registration**: Save new FLOW for future reuse

## Usage

### Interactive Mode
```
python flow.py
Flow> Build a web scraper that extracts prices and saves to CSV
```

### CLI Mode
```bash
python flow.py "Create an automation that monitors API endpoints"
```

### List Skills
```bash
python flow.py --list
```

## Security Features

- Code execution detection (eval, exec)
- Data exfiltration pattern matching
- Crypto mining indicator scanning
- System modification attempt detection
- AST-based code analysis
- Obfuscation detection

## Architecture

- `flow.py` - Main orchestrator
- `natural_language_parser.py` - NLP for user intent
- `skill_registry.py` - Reusable skill database
- `skill_scanner_integration.py` - Security scanning
- `skill_composer.py` - Compiles skills into FLOW

## Requirements

- Python 3.8+
- No external dependencies for core functionality

## Author

@bvinci1-design

# Flow - Intelligent Skill Orchestrator

Flow allows users to express build ideas or tasks in natural language, finds the best existing skills, scans them for security, and compiles them into a single executable FLOW skill.

## Features

- **Natural Language Processing**: Describe what you want to build in plain English
- **Skill Registry**: Reusable object architecture - never reinvent the wheel
- **Security Scanning**: Integrated security checks for malware, spyware, and malicious code
- **Smart Composition**: Automatically combines skills into unified workflows
- **Dependency Resolution**: Handles skill dependencies with topological sorting

## Installation

### Prerequisites

- Python 3.8+
- pip

### Clone the Repository

```bash
git clone https://github.com/bvinci1-design/flow.git
cd flow
```

### Install Dependencies

```bash
pip install -r requirements.txt
```

## How to Run

### Web UI (Streamlit Interface)

For the most user-friendly experience, use the Streamlit web interface:

```bash
streamlit run streamlit_ui.py
```

This will open a web interface in your browser with:
- 🏠 **Build Flow**: Enter natural language requests and watch the 5-step process
- 📚 **Skill Registry**: Browse, search, and filter available skills
- ℹ️ **About**: Learn more about Flow's architecture and features

The web UI provides real-time feedback on:
- Intent parsing results
- Skill matching scores
- Security scan status (✅ Safe / ⚠️ Warning / ❌ Unsafe)
- Composition progress

### In Clawdbot

1. Import the Flow skill into Clawdbot
2. Use natural language to describe what you want:
   ```
   Flow> Build a web scraper that extracts product prices and saves to CSV
   ```
3. Flow will:
   - Parse your request
   - Search for existing skills
   - Security scan all components
   - Compose a unified FLOW skill

### On Any Device (CLI)

#### Interactive Mode
```bash
python flow.py
```

Then type your requests:
```
Flow> Create an automation that monitors a webpage for changes
Flow> q...