Metadata-Version: 2.4
Name: watflow
Version: 0.0.1
Summary: WAT Framework for AI-powered workflow automations
License: MIT
License-File: LICENSE
Keywords: automation,workflow,ai,claude,agents
Author: cilladev
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides-Extra: all
Provides-Extra: claude
Provides-Extra: deploy
Provides-Extra: gmail
Provides-Extra: google
Provides-Extra: modal
Requires-Dist: anthropic (>=0.18.0) ; extra == "claude" or extra == "all"
Requires-Dist: click (>=8.0)
Requires-Dist: google-api-python-client (>=2.0) ; extra == "gmail" or extra == "google" or extra == "all"
Requires-Dist: google-auth-httplib2 (>=0.2) ; extra == "gmail" or extra == "google" or extra == "all"
Requires-Dist: google-auth-oauthlib (>=1.0) ; extra == "gmail" or extra == "google" or extra == "all"
Requires-Dist: modal (>=0.64.0) ; extra == "modal" or extra == "deploy" or extra == "all"
Requires-Dist: pydantic (>=2.0) ; extra == "claude" or extra == "all"
Requires-Dist: python-dotenv (>=1.0)
Requires-Dist: pyyaml (>=6.0)
Requires-Dist: rich (>=13.0)
Project-URL: Documentation, https://github.com/cilladev/watflow#readme
Project-URL: Homepage, https://github.com/cilladev/watflow
Project-URL: Repository, https://github.com/cilladev/watflow
Description-Content-Type: text/markdown

# WATFlow

WAT Framework for AI-powered workflow automations.

## Installation

```bash
uv pip install watflow

# With optional integrations
uv pip install watflow[claude]      # Claude AI integration
uv pip install watflow[gmail]       # Gmail integration
uv pip install watflow[all]         # All integrations
```

## Quick Start

```bash
# Create a new workflow
wat new my-workflow --category automation

# List available workflows
wat list

# Validate a workflow
wat validate my-workflow

# Run a workflow
wat run my-workflow

# Deploy to Modal (serverless)
wat deploy my-workflow
```

## Example Automations

Find ready-to-use workflow automations at:

**https://github.com/cilladev/watflow-automations**

## What is WAT?

**WAT = Workflows + Agents + Tools**

The WAT Framework separates AI reasoning from deterministic code execution:

- **Workflows**: Markdown SOPs defining what to do
- **Agents**: Claude AI for intelligent orchestration
- **Tools**: Python scripts for reliable execution

## Workflow Structure

Each workflow is a self-contained directory:

```
my-workflow/
├── config.yaml          # Workflow configuration
├── main.py              # Entry point
├── requirements.txt     # Dependencies
├── .env                 # API keys (gitignored)
├── tools/               # Python scripts
│   └── fetch_data.py
└── workflows/           # Markdown SOPs
    └── collect.md
```

## Deployment

Deploy workflows to Modal for scheduled execution:

```bash
# Install Modal
uv pip install modal
modal setup

# Deploy (one-command)
wat deploy my-workflow
```

## Documentation

- [Getting Started](docs/getting-started.md)
- [Configuration](docs/configuration.md)
- [CLI Reference](docs/cli-reference.md)
- [Deployment](docs/deployment.md)
- [Integrations](docs/integrations.md)

## License

MIT

