# ClearFlow

> Message-driven workflows with observable flows for emergent AI.

## Quick Start

- [Install from PyPI](https://pypi.org/project/clearflow/): pip install clearflow

## Documentation

- [README](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/README.md): Documentation
- [Core API](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/clearflow/__init__.py): Complete implementation - Node, NodeResult, Flow, and exceptions in a single module
- [CLAUDE Guidelines](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/CLAUDE.md): Documentation

## Examples

- [Portfolio Analysis](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/examples/portfolio_analysis/README.md): Portfolio Analysis Example

## Testing

- [Flow Tests](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/tests/test_flow.py): Test flow routing and composition
- [Message](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/tests/test_message.py): Test Message, Command, and Event base classes
- [Node Tests](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/tests/test_node.py): Test message Node abstraction features
- [Observe](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/tests/test_observe.py): Tests for callback system using only public API

## Optional

- [License](https://raw.githubusercontent.com/artificial-sapience/ClearFlow/main/LICENSE): MIT License