Metadata-Version: 2.4
Name: viviphi
Version: 1.1.0
Summary: Turn static graphs into beautiful animations
Author-email: Davit Budaghyan <david@budaghyan.com>
Maintainer-email: Davit Budaghyan <david@budaghyan.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/viviphi/viviphi
Project-URL: Documentation, https://github.com/viviphi/viviphi#readme
Project-URL: Repository, https://github.com/viviphi/viviphi.git
Project-URL: Bug Tracker, https://github.com/viviphi/viviphi/issues
Keywords: animation,svg,mermaid,graphs,diagrams,visualization
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing :: Markup :: HTML
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.28.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: litellm>=1.80.7
Requires-Dist: loguru>=0.7.3
Requires-Dist: lxml>=6.0.2
Requires-Dist: matplotlib>=3.10.7
Requires-Dist: networkx>=3.6
Requires-Dist: playwright>=1.56.0
Requires-Dist: pydantic>=2.12.5
Requires-Dist: svgpathtools>=1.7.1
Dynamic: license-file

# 🎬 Viviphi

Turn static graphs into beautiful animations!

Viviphi transforms your Mermaid.js diagrams into stunning animated SVGs with customizable themes and smooth transitions. Perfect for presentations, documentation, or just making your diagrams come alive.

## ✨ Features

- 🎨 **Multiple Themes**: Cyberpunk, Corporate, and Hand-drawn styles
- ⚡ **Easy to Use**: Simple Python API with just a few lines of code
- 🎯 **Mermaid Compatible**: Works with standard Mermaid.js syntax
- 🚀 **Fast Rendering**: Powered by Playwright for reliable SVG generation
- 🎛️ **Customizable**: Adjustable animation speeds and timing

## 🚀 Quick Start

### Installation

```bash
# Install viviphi
uv add viviphi

# Install browser dependencies
uv run playwright install chromium
```

### Basic Usage

```python
from viviphi import Graph, CYBERPUNK

# Define your Mermaid graph
mermaid_code = """
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
    C --> E[End]
    D --> E
"""

# Create and animate
graph = Graph(mermaid_code)
animated_svg = graph.animate(theme=CYBERPUNK, output="my_graph.svg")
```

That's it! Your animated SVG is ready.

## 🎨 Themes

Viviphi comes with three built-in themes:

### Cyberpunk 🌆
```python
from viviphi import Graph, CYBERPUNK

graph = Graph(mermaid_code)
graph.animate(theme=CYBERPUNK, output="cyberpunk_graph.svg")
```

### Corporate 💼
```python
from viviphi import Graph, CORPORATE

graph = Graph(mermaid_code)
graph.animate(theme=CORPORATE, output="corporate_graph.svg")
```

### Hand Drawn ✏️
```python
from viviphi import Graph, HAND_DRAWN

graph = Graph(mermaid_code)
graph.animate(theme=HAND_DRAWN, output="hand_drawn_graph.svg")
```

## ⚡ Animation Speed

Control the animation speed with the `speed` parameter:

```python
# Slow and dramatic
graph.animate(theme=CYBERPUNK, speed="slow")

# Default speed
graph.animate(theme=CYBERPUNK, speed="normal")

# Quick and snappy
graph.animate(theme=CYBERPUNK, speed="fast")
```

## 📊 Supported Diagram Types

Viviphi works with all standard Mermaid diagram types:

### Flowcharts
```python
flowchart = """
graph LR
    A[User] --> B[Login]
    B --> C{Valid?}
    C -->|Yes| D[Dashboard]
    C -->|No| E[Error]
"""
```

### Sequence Diagrams
```python
sequence = """
sequenceDiagram
    participant A as Alice
    participant B as Bob
    A->>B: Hello Bob
    B->>A: Hello Alice
"""
```

### Class Diagrams
```python
class_diagram = """
classDiagram
    class Vehicle {
        +String make
        +String model
        +start()
        +stop()
    }
    class Car {
        +openTrunk()
    }
    Vehicle <|-- Car
"""
```

### State Diagrams
```python
state_diagram = """
stateDiagram-v2
    [*] --> Idle
    Idle --> Running: start()
    Running --> Idle: stop()
    Running --> [*]: shutdown()
"""
```

## 🔧 Advanced Usage

### Batch Processing

Process multiple diagrams at once:

```python
from pathlib import Path
from viviphi import Graph, CYBERPUNK, CORPORATE, HAND_DRAWN

def animate_all_diagrams(input_dir: Path, output_dir: Path):
    themes = {
        "cyberpunk": CYBERPUNK,
        "corporate": CORPORATE, 
        "hand_drawn": HAND_DRAWN
    }
    
    for mermaid_file in input_dir.glob("*.mmd"):
        content = mermaid_file.read_text()
        graph = Graph(content)
        
        for theme_name, theme in themes.items():
            output_file = output_dir / f"{mermaid_file.stem}_{theme_name}.svg"
            graph.animate(theme=theme, output=str(output_file))
```

### Custom Timing

Fine-tune animation timing:

```python
from viviphi import Graph, Theme

# Create a custom theme with specific timing
custom_theme = Theme(
    primary_color="#ff6b6b",
    background="#2d3748",
    edge_style="neon",
    animation_duration=2.5,  # Longer animations
    stagger_delay=0.5        # More delay between elements
)

graph = Graph(mermaid_code)
graph.animate(theme=custom_theme)
```

## 🎯 Real-World Examples

### Documentation Workflow
```python
from viviphi import Graph, CORPORATE

# Load your workflow diagram
workflow = """
graph TD
    A[Write Code] --> B[Create Mermaid Diagram]
    B --> C[Generate Animated SVG]
    C --> D[Include in Documentation]
    D --> E[Profit! 🎉]
"""

# Generate for docs
graph = Graph(workflow)
graph.animate(theme=CORPORATE, speed="normal", output="docs/workflow.svg")
```

### System Architecture
```python
from viviphi import Graph, CYBERPUNK

architecture = """
graph TB
    subgraph "Frontend"
        UI[React App]
        API[API Client]
    end
    
    subgraph "Backend" 
        SERVER[Express Server]
        DB[(PostgreSQL)]
        CACHE[(Redis)]
    end
    
    UI --> API
    API --> SERVER
    SERVER --> DB
    SERVER --> CACHE
"""

graph = Graph(architecture)
graph.animate(theme=CYBERPUNK, output="architecture.svg")
```

## 📁 Project Structure

```
viviphi/
├── viviphi/           # Main package
│   ├── animator.py    # SVG animation engine  
│   ├── graph.py       # Main Graph class
│   ├── mermaid.py     # Mermaid rendering
│   └── themes.py      # Theme definitions
├── examples/          # Usage examples
├── resources/         # Sample Mermaid files
└── tests/            # Test suite
```

## 🛠️ Development

```bash
# Clone the repository
git clone <repository-url>
cd viviphi

# Install dependencies
uv sync --no-install-project

# Run tests
uv run pytest

# Check code quality
ruff check
ruff format
```

## 🤝 Contributing

We welcome contributions! Please feel free to submit issues and pull requests.

## 📄 License

This project is open source. See LICENSE file for details.

---

**Made with ❤️ by the Viviphi team**

*Transform your static diagrams into dynamic stories!*
