vibe-aigc 0.1.0__tar.gz → 0.1.1__tar.gz

vibe_aigc-0.1.1/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: vibe-aigc
+Version: 0.1.1
+Summary: A New Paradigm for Content Generation via Agentic Orchestration
+Author: Vibe AIGC Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://jmanhype.github.io/vibe-aigc
+Project-URL: Repository, https://github.com/jmanhype/vibe-aigc
+Project-URL: Documentation, https://jmanhype.github.io/vibe-aigc
+Project-URL: Changelog, https://jmanhype.github.io/vibe-aigc/changelog
+Project-URL: Issues, https://github.com/jmanhype/vibe-aigc/issues
+Keywords: ai,aigc,agents,orchestration,content-generation,llm,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: openai>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
+Dynamic: license-file
+
+# Vibe AIGC
+
+[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jmanhype/vibe-aigc/branch/main/graph/badge.svg)](https://codecov.io/gh/jmanhype/vibe-aigc)
+[![PyPI](https://img.shields.io/pypi/v/vibe-aigc.svg)](https://pypi.org/project/vibe-aigc/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://jmanhype.github.io/vibe-aigc)
+
+**A New Paradigm for Content Generation via Agentic Orchestration**
+
+Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
+
+📚 **[Documentation](https://jmanhype.github.io/vibe-aigc)** | 🚀 **[Quick Start](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)** | 📖 **[API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)**
+
+---
+
+## What is Vibe AIGC?
+
+Vibe AIGC bridges the **Intent-Execution Gap** in AI content generation. Instead of prompt engineering, you provide a **Vibe** — a high-level representation of your creative intent — and the system automatically decomposes it into executable workflows.
+
+```python
+from vibe_aigc import MetaPlanner, Vibe
+
+# Express your intent
+vibe = Vibe(
+    description="Create a cinematic sci-fi trailer",
+    style="dark, atmospheric, Blade Runner aesthetic",
+    constraints=["under 60 seconds", "no dialogue"]
+)
+
+# Let the Meta-Planner handle the rest
+planner = MetaPlanner()
+result = await planner.execute(vibe)
+```
+
+## Features
+
+- 🎯 **Vibe-based Planning** — High-level intent → executable workflows
+- ⚡ **Parallel Execution** — Independent nodes run concurrently
+- 🔄 **Adaptive Replanning** — Automatic recovery from failures
+- 💾 **Checkpoint/Resume** — Save and restore workflow state
+- 📊 **Progress Tracking** — Real-time callbacks and visualization
+- 🎨 **Workflow Visualization** — ASCII and Mermaid diagrams
+
+## Installation
+
+```bash
+pip install vibe-aigc
+```
+
+## CLI Usage
+
+```bash
+# Generate a workflow plan
+vibe-aigc plan "Create a blog post about AI" --style "informative" --format ascii
+
+# Execute a vibe
+vibe-aigc execute "Design a landing page" --visualize --checkpoint
+
+# Manage checkpoints
+vibe-aigc checkpoints --list
+```
+
+## Quick Example
+
+```python
+import asyncio
+from vibe_aigc import Vibe, MetaPlanner
+
+async def main():
+    vibe = Vibe(
+        description="Write a blog post about AI agents",
+        style="informative, engaging",
+        constraints=["under 1000 words"]
+    )
+    
+    planner = MetaPlanner()
+    result = await planner.execute_with_visualization(vibe)
+    
+    print(f"Status: {result.get_summary()['status']}")
+
+asyncio.run(main())
+```
+
+## Architecture
+
+```
+User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
+     ↑                           ↓
+     └──── Feedback Loop ────────┘
+```
+
+## Documentation
+
+- [Installation Guide](https://jmanhype.github.io/vibe-aigc/getting-started/installation/)
+- [Quick Start Tutorial](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)
+- [Core Concepts](https://jmanhype.github.io/vibe-aigc/guide/concepts/)
+- [API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)
+- [Examples](https://jmanhype.github.io/vibe-aigc/examples/)
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Citation
+
+```bibtex
+@article{vibe-aigc-2025,
+  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
+  journal={arXiv preprint arXiv:2602.04575},
+  year={2025}
+}
+```

vibe_aigc-0.1.1/README.md

@@ -0,0 +1,118 @@
+# Vibe AIGC
+
+[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jmanhype/vibe-aigc/branch/main/graph/badge.svg)](https://codecov.io/gh/jmanhype/vibe-aigc)
+[![PyPI](https://img.shields.io/pypi/v/vibe-aigc.svg)](https://pypi.org/project/vibe-aigc/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://jmanhype.github.io/vibe-aigc)
+
+**A New Paradigm for Content Generation via Agentic Orchestration**
+
+Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
+
+📚 **[Documentation](https://jmanhype.github.io/vibe-aigc)** | 🚀 **[Quick Start](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)** | 📖 **[API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)**
+
+---
+
+## What is Vibe AIGC?
+
+Vibe AIGC bridges the **Intent-Execution Gap** in AI content generation. Instead of prompt engineering, you provide a **Vibe** — a high-level representation of your creative intent — and the system automatically decomposes it into executable workflows.
+
+```python
+from vibe_aigc import MetaPlanner, Vibe
+
+# Express your intent
+vibe = Vibe(
+    description="Create a cinematic sci-fi trailer",
+    style="dark, atmospheric, Blade Runner aesthetic",
+    constraints=["under 60 seconds", "no dialogue"]
+)
+
+# Let the Meta-Planner handle the rest
+planner = MetaPlanner()
+result = await planner.execute(vibe)
+```
+
+## Features
+
+- 🎯 **Vibe-based Planning** — High-level intent → executable workflows
+- ⚡ **Parallel Execution** — Independent nodes run concurrently
+- 🔄 **Adaptive Replanning** — Automatic recovery from failures
+- 💾 **Checkpoint/Resume** — Save and restore workflow state
+- 📊 **Progress Tracking** — Real-time callbacks and visualization
+- 🎨 **Workflow Visualization** — ASCII and Mermaid diagrams
+
+## Installation
+
+```bash
+pip install vibe-aigc
+```
+
+## CLI Usage
+
+```bash
+# Generate a workflow plan
+vibe-aigc plan "Create a blog post about AI" --style "informative" --format ascii
+
+# Execute a vibe
+vibe-aigc execute "Design a landing page" --visualize --checkpoint
+
+# Manage checkpoints
+vibe-aigc checkpoints --list
+```
+
+## Quick Example
+
+```python
+import asyncio
+from vibe_aigc import Vibe, MetaPlanner
+
+async def main():
+    vibe = Vibe(
+        description="Write a blog post about AI agents",
+        style="informative, engaging",
+        constraints=["under 1000 words"]
+    )
+    
+    planner = MetaPlanner()
+    result = await planner.execute_with_visualization(vibe)
+    
+    print(f"Status: {result.get_summary()['status']}")
+
+asyncio.run(main())
+```
+
+## Architecture
+
+```
+User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
+     ↑                           ↓
+     └──── Feedback Loop ────────┘
+```
+
+## Documentation
+
+- [Installation Guide](https://jmanhype.github.io/vibe-aigc/getting-started/installation/)
+- [Quick Start Tutorial](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)
+- [Core Concepts](https://jmanhype.github.io/vibe-aigc/guide/concepts/)
+- [API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)
+- [Examples](https://jmanhype.github.io/vibe-aigc/examples/)
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Citation
+
+```bibtex
+@article{vibe-aigc-2025,
+  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
+  journal={arXiv preprint arXiv:2602.04575},
+  year={2025}
+}
+```

{vibe_aigc-0.1.0 → vibe_aigc-0.1.1}/pyproject.toml

@@ -2,9 +2,13 @@
 requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
+[tool.setuptools.packages.find]
+include = ["vibe_aigc*"]
+exclude = ["tests*", "docs*", "examples*", "landing*"]
+
 [project]
 name = "vibe-aigc"
-version = "0.1.0"
+version = "0.1.1"
 description = "A New Paradigm for Content Generation via Agentic Orchestration"
 authors = [{name = "Vibe AIGC Contributors"}]
 license = "MIT"
@@ -32,11 +36,20 @@ dev = [
     "ruff>=0.1.0",
     "mypy>=1.0.0",
 ]
+docs = [
+    "mkdocs-material>=9.0.0",
+    "mkdocstrings[python]>=0.24.0",
+    "pymdown-extensions>=10.0.0",
+]
+
+[project.scripts]
+vibe-aigc = "vibe_aigc.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/jmanhype/vibe-aigc"
+Homepage = "https://jmanhype.github.io/vibe-aigc"
 Repository = "https://github.com/jmanhype/vibe-aigc"
-Documentation = "https://github.com/jmanhype/vibe-aigc#readme"
+Documentation = "https://jmanhype.github.io/vibe-aigc"
+Changelog = "https://jmanhype.github.io/vibe-aigc/changelog"
 Issues = "https://github.com/jmanhype/vibe-aigc/issues"
 
 [tool.pytest.ini_options]

{vibe_aigc-0.1.0 → vibe_aigc-0.1.1}/vibe_aigc/__init__.py

@@ -5,7 +5,7 @@ from .planner import MetaPlanner
 from .llm import LLMClient, LLMConfig
 from .executor import WorkflowExecutor, ExecutionStatus, ExecutionResult
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"
 __all__ = [
     "Vibe", "WorkflowPlan", "WorkflowNode", "WorkflowNodeType",
     "MetaPlanner", "LLMClient", "LLMConfig",

vibe_aigc-0.1.1/vibe_aigc/cli.py

@@ -0,0 +1,205 @@
+"""Command-line interface for Vibe AIGC."""
+
+import argparse
+import asyncio
+import json
+import sys
+from typing import Optional
+
+from .models import Vibe
+from .planner import MetaPlanner
+from .visualization import WorkflowVisualizer, VisualizationFormat
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create argument parser for CLI."""
+    parser = argparse.ArgumentParser(
+        prog="vibe-aigc",
+        description="Vibe AIGC - Content Generation via Agentic Orchestration",
+    )
+    parser.add_argument("--version", action="version", version="%(prog)s 0.1.1")
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # Plan command
+    plan_parser = subparsers.add_parser("plan", help="Generate a workflow plan from a vibe")
+    plan_parser.add_argument("description", help="Main description of what you want to create")
+    plan_parser.add_argument("--style", "-s", help="Style preferences")
+    plan_parser.add_argument("--constraints", "-c", nargs="*", default=[], help="Constraints")
+    plan_parser.add_argument("--domain", "-d", help="Domain context")
+    plan_parser.add_argument("--format", "-f", choices=["ascii", "mermaid", "json"], default="ascii")
+    plan_parser.add_argument("--output", "-o", help="Output file (default: stdout)")
+
+    # Execute command
+    exec_parser = subparsers.add_parser("execute", help="Plan and execute a vibe")
+    exec_parser.add_argument("description", help="Main description of what you want to create")
+    exec_parser.add_argument("--style", "-s", help="Style preferences")
+    exec_parser.add_argument("--constraints", "-c", nargs="*", default=[], help="Constraints")
+    exec_parser.add_argument("--domain", "-d", help="Domain context")
+    exec_parser.add_argument("--checkpoint", action="store_true", help="Enable checkpointing")
+    exec_parser.add_argument("--checkpoint-interval", type=int, default=5, help="Checkpoint interval")
+    exec_parser.add_argument("--visualize", "-v", action="store_true", help="Show visualization")
+    exec_parser.add_argument("--adapt", "-a", action="store_true", help="Enable adaptive replanning")
+
+    # Resume command
+    resume_parser = subparsers.add_parser("resume", help="Resume from a checkpoint")
+    resume_parser.add_argument("checkpoint_id", help="Checkpoint ID to resume from")
+
+    # Checkpoints command
+    cp_parser = subparsers.add_parser("checkpoints", help="List or manage checkpoints")
+    cp_parser.add_argument("--list", "-l", action="store_true", help="List all checkpoints")
+    cp_parser.add_argument("--delete", "-d", help="Delete a checkpoint by ID")
+    cp_parser.add_argument("--clear", action="store_true", help="Delete all checkpoints")
+
+    return parser
+
+
+def create_vibe(args) -> Vibe:
+    """Create a Vibe from CLI arguments."""
+    return Vibe(
+        description=args.description,
+        style=args.style,
+        constraints=args.constraints or [],
+        domain=args.domain,
+    )
+
+
+async def cmd_plan(args) -> int:
+    """Handle plan command."""
+    vibe = create_vibe(args)
+    planner = MetaPlanner()
+
+    print(f"Planning workflow for: {vibe.description}", file=sys.stderr)
+    plan = await planner.plan(vibe)
+
+    if args.format == "json":
+        output = plan.model_dump_json(indent=2)
+    elif args.format == "mermaid":
+        output = WorkflowVisualizer.generate_diagram(plan, format=VisualizationFormat.MERMAID)
+    else:
+        output = WorkflowVisualizer.generate_diagram(plan, format=VisualizationFormat.ASCII)
+
+    if args.output:
+        with open(args.output, "w") as f:
+            f.write(output)
+        print(f"Output written to {args.output}", file=sys.stderr)
+    else:
+        print(output)
+
+    return 0
+
+
+async def cmd_execute(args) -> int:
+    """Handle execute command."""
+    vibe = create_vibe(args)
+
+    checkpoint_interval = args.checkpoint_interval if args.checkpoint else None
+    planner = MetaPlanner(checkpoint_interval=checkpoint_interval)
+
+    def on_progress(event):
+        status = {"started": "🚀", "completed": "✅", "failed": "❌"}.get(event.event_type, "📍")
+        print(f"{status} [{event.node_id}] {event.message}", file=sys.stderr)
+
+    if args.visualize:
+        planner = MetaPlanner(
+            checkpoint_interval=checkpoint_interval,
+            progress_callback=on_progress
+        )
+
+    print(f"Executing workflow for: {vibe.description}", file=sys.stderr)
+
+    if args.adapt:
+        result = await planner.execute_with_adaptation(vibe)
+    elif args.checkpoint:
+        result = await planner.execute_with_resume(vibe)
+    elif args.visualize:
+        result = await planner.execute_with_visualization(vibe)
+    else:
+        result = await planner.execute(vibe)
+
+    summary = result.get_summary()
+    print(f"\n{'='*50}", file=sys.stderr)
+    print(f"Status: {summary['status']}", file=sys.stderr)
+    print(f"Completed: {summary['completed']}/{summary['total_nodes']} nodes", file=sys.stderr)
+
+    return 0 if summary['status'] == 'completed' else 1
+
+
+async def cmd_checkpoints(args) -> int:
+    """Handle checkpoints command."""
+    planner = MetaPlanner()
+
+    if args.delete:
+        planner.delete_checkpoint(args.delete)
+        print(f"Deleted checkpoint: {args.delete}")
+    elif args.clear:
+        checkpoints = planner.list_checkpoints()
+        for cp in checkpoints:
+            planner.delete_checkpoint(cp["checkpoint_id"])
+        print(f"Deleted {len(checkpoints)} checkpoint(s)")
+    else:
+        checkpoints = planner.list_checkpoints()
+        if not checkpoints:
+            print("No checkpoints found.")
+        else:
+            print(f"Found {len(checkpoints)} checkpoint(s):\n")
+            for cp in checkpoints:
+                print(f"  ID: {cp['checkpoint_id']}")
+                print(f"  Created: {cp.get('created_at', 'unknown')}")
+                print(f"  Progress: {cp.get('completed_nodes', '?')}/{cp.get('total_nodes', '?')} nodes")
+                print()
+
+    return 0
+
+
+async def cmd_resume(args) -> int:
+    """Handle resume command."""
+    planner = MetaPlanner()
+
+    print(f"Resuming from checkpoint: {args.checkpoint_id}", file=sys.stderr)
+
+    # Need to get the vibe from checkpoint
+    checkpoint = planner.get_checkpoint(args.checkpoint_id)
+    if not checkpoint:
+        print(f"Checkpoint not found: {args.checkpoint_id}", file=sys.stderr)
+        return 1
+
+    vibe = Vibe(**checkpoint.get("vibe", {}))
+    result = await planner.execute_with_resume(vibe, checkpoint_id=args.checkpoint_id)
+
+    summary = result.get_summary()
+    print(f"\nStatus: {summary['status']}", file=sys.stderr)
+    print(f"Completed: {summary['completed']}/{summary['total_nodes']} nodes", file=sys.stderr)
+
+    return 0 if summary['status'] == 'completed' else 1
+
+
+async def async_main(args) -> int:
+    """Async main entry point."""
+    if args.command == "plan":
+        return await cmd_plan(args)
+    elif args.command == "execute":
+        return await cmd_execute(args)
+    elif args.command == "checkpoints":
+        return await cmd_checkpoints(args)
+    elif args.command == "resume":
+        return await cmd_resume(args)
+    else:
+        print("Use --help for usage information.", file=sys.stderr)
+        return 1
+
+
+def main() -> int:
+    """Main entry point for CLI."""
+    parser = create_parser()
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        return 0
+
+    return asyncio.run(async_main(args))
+
+
+if __name__ == "__main__":
+    sys.exit(main())

vibe_aigc-0.1.1/vibe_aigc.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: vibe-aigc
+Version: 0.1.1
+Summary: A New Paradigm for Content Generation via Agentic Orchestration
+Author: Vibe AIGC Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://jmanhype.github.io/vibe-aigc
+Project-URL: Repository, https://github.com/jmanhype/vibe-aigc
+Project-URL: Documentation, https://jmanhype.github.io/vibe-aigc
+Project-URL: Changelog, https://jmanhype.github.io/vibe-aigc/changelog
+Project-URL: Issues, https://github.com/jmanhype/vibe-aigc/issues
+Keywords: ai,aigc,agents,orchestration,content-generation,llm,workflow
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: openai>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
+Dynamic: license-file
+
+# Vibe AIGC
+
+[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jmanhype/vibe-aigc/branch/main/graph/badge.svg)](https://codecov.io/gh/jmanhype/vibe-aigc)
+[![PyPI](https://img.shields.io/pypi/v/vibe-aigc.svg)](https://pypi.org/project/vibe-aigc/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://jmanhype.github.io/vibe-aigc)
+
+**A New Paradigm for Content Generation via Agentic Orchestration**
+
+Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
+
+📚 **[Documentation](https://jmanhype.github.io/vibe-aigc)** | 🚀 **[Quick Start](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)** | 📖 **[API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)**
+
+---
+
+## What is Vibe AIGC?
+
+Vibe AIGC bridges the **Intent-Execution Gap** in AI content generation. Instead of prompt engineering, you provide a **Vibe** — a high-level representation of your creative intent — and the system automatically decomposes it into executable workflows.
+
+```python
+from vibe_aigc import MetaPlanner, Vibe
+
+# Express your intent
+vibe = Vibe(
+    description="Create a cinematic sci-fi trailer",
+    style="dark, atmospheric, Blade Runner aesthetic",
+    constraints=["under 60 seconds", "no dialogue"]
+)
+
+# Let the Meta-Planner handle the rest
+planner = MetaPlanner()
+result = await planner.execute(vibe)
+```
+
+## Features
+
+- 🎯 **Vibe-based Planning** — High-level intent → executable workflows
+- ⚡ **Parallel Execution** — Independent nodes run concurrently
+- 🔄 **Adaptive Replanning** — Automatic recovery from failures
+- 💾 **Checkpoint/Resume** — Save and restore workflow state
+- 📊 **Progress Tracking** — Real-time callbacks and visualization
+- 🎨 **Workflow Visualization** — ASCII and Mermaid diagrams
+
+## Installation
+
+```bash
+pip install vibe-aigc
+```
+
+## CLI Usage
+
+```bash
+# Generate a workflow plan
+vibe-aigc plan "Create a blog post about AI" --style "informative" --format ascii
+
+# Execute a vibe
+vibe-aigc execute "Design a landing page" --visualize --checkpoint
+
+# Manage checkpoints
+vibe-aigc checkpoints --list
+```
+
+## Quick Example
+
+```python
+import asyncio
+from vibe_aigc import Vibe, MetaPlanner
+
+async def main():
+    vibe = Vibe(
+        description="Write a blog post about AI agents",
+        style="informative, engaging",
+        constraints=["under 1000 words"]
+    )
+    
+    planner = MetaPlanner()
+    result = await planner.execute_with_visualization(vibe)
+    
+    print(f"Status: {result.get_summary()['status']}")
+
+asyncio.run(main())
+```
+
+## Architecture
+
+```
+User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
+     ↑                           ↓
+     └──── Feedback Loop ────────┘
+```
+
+## Documentation
+
+- [Installation Guide](https://jmanhype.github.io/vibe-aigc/getting-started/installation/)
+- [Quick Start Tutorial](https://jmanhype.github.io/vibe-aigc/getting-started/quickstart/)
+- [Core Concepts](https://jmanhype.github.io/vibe-aigc/guide/concepts/)
+- [API Reference](https://jmanhype.github.io/vibe-aigc/api/models/)
+- [Examples](https://jmanhype.github.io/vibe-aigc/examples/)
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Citation
+
+```bibtex
+@article{vibe-aigc-2025,
+  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
+  journal={arXiv preprint arXiv:2602.04575},
+  year={2025}
+}
+```

{vibe_aigc-0.1.0 → vibe_aigc-0.1.1}/vibe_aigc.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ tests/test_progress_callbacks.py
 tests/test_visualization.py
 tests/test_workflow_resume.py
 vibe_aigc/__init__.py
+vibe_aigc/cli.py
 vibe_aigc/executor.py
 vibe_aigc/llm.py
 vibe_aigc/models.py
@@ -27,5 +28,6 @@ vibe_aigc/visualization.py
 vibe_aigc.egg-info/PKG-INFO
 vibe_aigc.egg-info/SOURCES.txt
 vibe_aigc.egg-info/dependency_links.txt
+vibe_aigc.egg-info/entry_points.txt
 vibe_aigc.egg-info/requires.txt
 vibe_aigc.egg-info/top_level.txt

vibe_aigc-0.1.1/vibe_aigc.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+vibe-aigc = vibe_aigc.cli:main

{vibe_aigc-0.1.0 → vibe_aigc-0.1.1}/vibe_aigc.egg-info/requires.txt

@@ -7,3 +7,8 @@ pytest-asyncio>=0.21.0
 black>=23.0.0
 ruff>=0.1.0
 mypy>=1.0.0
+
+[docs]
+mkdocs-material>=9.0.0
+mkdocstrings[python]>=0.24.0
+pymdown-extensions>=10.0.0

vibe_aigc-0.1.0/PKG-INFO

@@ -1,193 +0,0 @@
-Metadata-Version: 2.4
-Name: vibe-aigc
-Version: 0.1.0
-Summary: A New Paradigm for Content Generation via Agentic Orchestration
-Author: Vibe AIGC Contributors
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/jmanhype/vibe-aigc
-Project-URL: Repository, https://github.com/jmanhype/vibe-aigc
-Project-URL: Documentation, https://github.com/jmanhype/vibe-aigc#readme
-Project-URL: Issues, https://github.com/jmanhype/vibe-aigc/issues
-Keywords: ai,aigc,agents,orchestration,content-generation,llm,workflow
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Typing :: Typed
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: openai>=1.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# Vibe AIGC
-
-[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**A New Paradigm for Content Generation via Agentic Orchestration**
-
-Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
-
-## Overview
-
-Vibe AIGC introduces a paradigm shift from model-centric to agentic orchestration for content generation. Instead of traditional prompt engineering, users provide a **Vibe** — a high-level representation encompassing aesthetic preferences, functional logic, and intent.
-
-## Key Features
-
-- 🎯 **Vibe-based Planning** — Decompose high-level intent into executable workflows
-- ⚡ **Parallel Execution** — Independent nodes execute concurrently for faster results
-- 🔄 **Adaptive Replanning** — Automatic workflow adaptation based on execution feedback
-- 💾 **Checkpoint/Resume** — Save and restore workflow state for long-running tasks
-- 📊 **Progress Tracking** — Real-time callbacks and visualization
-- 🎨 **Workflow Visualization** — ASCII and Mermaid diagram generation
-
-## Architecture
-
-```
-User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
-     ↑                           ↓
-     └──── Feedback Loop ────────┘
-```
-
-## Installation
-
-```bash
-pip install -e .
-```
-
-## Quick Start
-
-```python
-from vibe_aigc import MetaPlanner, Vibe
-
-# Define your vibe
-vibe = Vibe(
-    description="Create a cinematic sci-fi scene",
-    style="dark, atmospheric",
-    constraints=["no violence", "PG-13"]
-)
-
-# Plan and execute
-planner = MetaPlanner()
-result = await planner.execute(vibe)
-```
-
-## Advanced Usage
-
-### With Progress Callbacks
-
-```python
-def on_progress(event):
-    print(f"[{event.event_type}] {event.message}")
-
-planner = MetaPlanner(progress_callback=on_progress)
-result = await planner.execute_with_visualization(vibe)
-```
-
-### With Checkpoint/Resume
-
-```python
-# Enable automatic checkpointing
-planner = MetaPlanner(checkpoint_interval=5)
-
-# Execute with checkpoints
-result = await planner.execute_with_resume(vibe)
-
-# Resume from a checkpoint
-checkpoints = planner.list_checkpoints()
-result = await planner.execute_with_resume(vibe, checkpoint_id=checkpoints[0]["checkpoint_id"])
-```
-
-### With Adaptive Replanning
-
-```python
-# Automatically adapt workflow on failures
-result = await planner.execute_with_adaptation(vibe)
-
-# Check adaptation history
-print(result["adaptation_info"])
-```
-
-## API Reference
-
-### Vibe
-
-```python
-Vibe(
-    description: str,      # What you want to create
-    style: str = None,     # Aesthetic preferences
-    constraints: list = [],# Boundaries and requirements
-    domain: str = None,    # Content domain
-    metadata: dict = {}    # Additional context
-)
-```
-
-### MetaPlanner
-
-| Method | Description |
-|--------|-------------|
-| `plan(vibe)` | Generate workflow plan without execution |
-| `execute(vibe)` | Plan and execute workflow |
-| `execute_with_adaptation(vibe)` | Execute with automatic replanning |
-| `execute_with_visualization(vibe)` | Execute with progress visualization |
-| `execute_with_resume(vibe, checkpoint_id)` | Execute with checkpoint support |
-| `list_checkpoints()` | List available checkpoints |
-| `get_checkpoint(id)` | Load a specific checkpoint |
-| `delete_checkpoint(id)` | Remove a checkpoint |
-
-## Testing
-
-```bash
-# Run all tests
-pytest -v
-
-# Run specific test file
-pytest tests/test_planner.py -v
-
-# Run with coverage
-pytest --cov=vibe_aigc
-```
-
-## Project Structure
-
-```
-vibe_aigc/
-├── __init__.py        # Package exports
-├── models.py          # Vibe, WorkflowPlan, WorkflowNode
-├── llm.py             # LLM client for plan generation
-├── planner.py         # MetaPlanner orchestration
-├── executor.py        # Workflow execution engine
-├── persistence.py     # Checkpoint management
-└── visualization.py   # Diagram generation
-```
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes with tests
-4. Submit a pull request
-
-## License
-
-MIT
-
-## Citation
-
-```bibtex
-@article{vibe-aigc-2025,
-  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
-  journal={arXiv preprint arXiv:2602.04575},
-  year={2025}
-}
-```

vibe_aigc-0.1.0/README.md

@@ -1,163 +0,0 @@
-# Vibe AIGC
-
-[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**A New Paradigm for Content Generation via Agentic Orchestration**
-
-Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
-
-## Overview
-
-Vibe AIGC introduces a paradigm shift from model-centric to agentic orchestration for content generation. Instead of traditional prompt engineering, users provide a **Vibe** — a high-level representation encompassing aesthetic preferences, functional logic, and intent.
-
-## Key Features
-
-- 🎯 **Vibe-based Planning** — Decompose high-level intent into executable workflows
-- ⚡ **Parallel Execution** — Independent nodes execute concurrently for faster results
-- 🔄 **Adaptive Replanning** — Automatic workflow adaptation based on execution feedback
-- 💾 **Checkpoint/Resume** — Save and restore workflow state for long-running tasks
-- 📊 **Progress Tracking** — Real-time callbacks and visualization
-- 🎨 **Workflow Visualization** — ASCII and Mermaid diagram generation
-
-## Architecture
-
-```
-User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
-     ↑                           ↓
-     └──── Feedback Loop ────────┘
-```
-
-## Installation
-
-```bash
-pip install -e .
-```
-
-## Quick Start
-
-```python
-from vibe_aigc import MetaPlanner, Vibe
-
-# Define your vibe
-vibe = Vibe(
-    description="Create a cinematic sci-fi scene",
-    style="dark, atmospheric",
-    constraints=["no violence", "PG-13"]
-)
-
-# Plan and execute
-planner = MetaPlanner()
-result = await planner.execute(vibe)
-```
-
-## Advanced Usage
-
-### With Progress Callbacks
-
-```python
-def on_progress(event):
-    print(f"[{event.event_type}] {event.message}")
-
-planner = MetaPlanner(progress_callback=on_progress)
-result = await planner.execute_with_visualization(vibe)
-```
-
-### With Checkpoint/Resume
-
-```python
-# Enable automatic checkpointing
-planner = MetaPlanner(checkpoint_interval=5)
-
-# Execute with checkpoints
-result = await planner.execute_with_resume(vibe)
-
-# Resume from a checkpoint
-checkpoints = planner.list_checkpoints()
-result = await planner.execute_with_resume(vibe, checkpoint_id=checkpoints[0]["checkpoint_id"])
-```
-
-### With Adaptive Replanning
-
-```python
-# Automatically adapt workflow on failures
-result = await planner.execute_with_adaptation(vibe)
-
-# Check adaptation history
-print(result["adaptation_info"])
-```
-
-## API Reference
-
-### Vibe
-
-```python
-Vibe(
-    description: str,      # What you want to create
-    style: str = None,     # Aesthetic preferences
-    constraints: list = [],# Boundaries and requirements
-    domain: str = None,    # Content domain
-    metadata: dict = {}    # Additional context
-)
-```
-
-### MetaPlanner
-
-| Method | Description |
-|--------|-------------|
-| `plan(vibe)` | Generate workflow plan without execution |
-| `execute(vibe)` | Plan and execute workflow |
-| `execute_with_adaptation(vibe)` | Execute with automatic replanning |
-| `execute_with_visualization(vibe)` | Execute with progress visualization |
-| `execute_with_resume(vibe, checkpoint_id)` | Execute with checkpoint support |
-| `list_checkpoints()` | List available checkpoints |
-| `get_checkpoint(id)` | Load a specific checkpoint |
-| `delete_checkpoint(id)` | Remove a checkpoint |
-
-## Testing
-
-```bash
-# Run all tests
-pytest -v
-
-# Run specific test file
-pytest tests/test_planner.py -v
-
-# Run with coverage
-pytest --cov=vibe_aigc
-```
-
-## Project Structure
-
-```
-vibe_aigc/
-├── __init__.py        # Package exports
-├── models.py          # Vibe, WorkflowPlan, WorkflowNode
-├── llm.py             # LLM client for plan generation
-├── planner.py         # MetaPlanner orchestration
-├── executor.py        # Workflow execution engine
-├── persistence.py     # Checkpoint management
-└── visualization.py   # Diagram generation
-```
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes with tests
-4. Submit a pull request
-
-## License
-
-MIT
-
-## Citation
-
-```bibtex
-@article{vibe-aigc-2025,
-  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
-  journal={arXiv preprint arXiv:2602.04575},
-  year={2025}
-}
-```

vibe_aigc-0.1.0/vibe_aigc.egg-info/PKG-INFO

@@ -1,193 +0,0 @@
-Metadata-Version: 2.4
-Name: vibe-aigc
-Version: 0.1.0
-Summary: A New Paradigm for Content Generation via Agentic Orchestration
-Author: Vibe AIGC Contributors
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/jmanhype/vibe-aigc
-Project-URL: Repository, https://github.com/jmanhype/vibe-aigc
-Project-URL: Documentation, https://github.com/jmanhype/vibe-aigc#readme
-Project-URL: Issues, https://github.com/jmanhype/vibe-aigc/issues
-Keywords: ai,aigc,agents,orchestration,content-generation,llm,workflow
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Typing :: Typed
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: openai>=1.0.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# Vibe AIGC
-
-[![CI](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml/badge.svg)](https://github.com/jmanhype/vibe-aigc/actions/workflows/ci.yml)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**A New Paradigm for Content Generation via Agentic Orchestration**
-
-Based on [arXiv:2602.04575](https://arxiv.org/abs/2602.04575)
-
-## Overview
-
-Vibe AIGC introduces a paradigm shift from model-centric to agentic orchestration for content generation. Instead of traditional prompt engineering, users provide a **Vibe** — a high-level representation encompassing aesthetic preferences, functional logic, and intent.
-
-## Key Features
-
-- 🎯 **Vibe-based Planning** — Decompose high-level intent into executable workflows
-- ⚡ **Parallel Execution** — Independent nodes execute concurrently for faster results
-- 🔄 **Adaptive Replanning** — Automatic workflow adaptation based on execution feedback
-- 💾 **Checkpoint/Resume** — Save and restore workflow state for long-running tasks
-- 📊 **Progress Tracking** — Real-time callbacks and visualization
-- 🎨 **Workflow Visualization** — ASCII and Mermaid diagram generation
-
-## Architecture
-
-```
-User Vibe → MetaPlanner → Agentic Pipeline → Execution → Result
-     ↑                           ↓
-     └──── Feedback Loop ────────┘
-```
-
-## Installation
-
-```bash
-pip install -e .
-```
-
-## Quick Start
-
-```python
-from vibe_aigc import MetaPlanner, Vibe
-
-# Define your vibe
-vibe = Vibe(
-    description="Create a cinematic sci-fi scene",
-    style="dark, atmospheric",
-    constraints=["no violence", "PG-13"]
-)
-
-# Plan and execute
-planner = MetaPlanner()
-result = await planner.execute(vibe)
-```
-
-## Advanced Usage
-
-### With Progress Callbacks
-
-```python
-def on_progress(event):
-    print(f"[{event.event_type}] {event.message}")
-
-planner = MetaPlanner(progress_callback=on_progress)
-result = await planner.execute_with_visualization(vibe)
-```
-
-### With Checkpoint/Resume
-
-```python
-# Enable automatic checkpointing
-planner = MetaPlanner(checkpoint_interval=5)
-
-# Execute with checkpoints
-result = await planner.execute_with_resume(vibe)
-
-# Resume from a checkpoint
-checkpoints = planner.list_checkpoints()
-result = await planner.execute_with_resume(vibe, checkpoint_id=checkpoints[0]["checkpoint_id"])
-```
-
-### With Adaptive Replanning
-
-```python
-# Automatically adapt workflow on failures
-result = await planner.execute_with_adaptation(vibe)
-
-# Check adaptation history
-print(result["adaptation_info"])
-```
-
-## API Reference
-
-### Vibe
-
-```python
-Vibe(
-    description: str,      # What you want to create
-    style: str = None,     # Aesthetic preferences
-    constraints: list = [],# Boundaries and requirements
-    domain: str = None,    # Content domain
-    metadata: dict = {}    # Additional context
-)
-```
-
-### MetaPlanner
-
-| Method | Description |
-|--------|-------------|
-| `plan(vibe)` | Generate workflow plan without execution |
-| `execute(vibe)` | Plan and execute workflow |
-| `execute_with_adaptation(vibe)` | Execute with automatic replanning |
-| `execute_with_visualization(vibe)` | Execute with progress visualization |
-| `execute_with_resume(vibe, checkpoint_id)` | Execute with checkpoint support |
-| `list_checkpoints()` | List available checkpoints |
-| `get_checkpoint(id)` | Load a specific checkpoint |
-| `delete_checkpoint(id)` | Remove a checkpoint |
-
-## Testing
-
-```bash
-# Run all tests
-pytest -v
-
-# Run specific test file
-pytest tests/test_planner.py -v
-
-# Run with coverage
-pytest --cov=vibe_aigc
-```
-
-## Project Structure
-
-```
-vibe_aigc/
-├── __init__.py        # Package exports
-├── models.py          # Vibe, WorkflowPlan, WorkflowNode
-├── llm.py             # LLM client for plan generation
-├── planner.py         # MetaPlanner orchestration
-├── executor.py        # Workflow execution engine
-├── persistence.py     # Checkpoint management
-└── visualization.py   # Diagram generation
-```
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes with tests
-4. Submit a pull request
-
-## License
-
-MIT
-
-## Citation
-
-```bibtex
-@article{vibe-aigc-2025,
-  title={Vibe AIGC: A New Paradigm for Content Generation via Agentic Orchestration},
-  journal={arXiv preprint arXiv:2602.04575},
-  year={2025}
-}
-```