flock-core 0.2.17__py3-none-any.whl → 0.2.18__py3-none-any.whl

flock/core/util/cli_helper.py

@@ -28,3 +28,22 @@ def display_banner():
     )
     console.print(banner_text)
     console.print(f"[bold]white duck GmbH[/] - [cyan]https://whiteduck.de[/]\n")
+
+
+def display_banner_no_version():
+    """Display the Flock banner."""
+    banner_text = Text(
+        f"""
+🦆    🐓     🐤     🐧
+╭━━━━━━━━━━━━━━━━━━━━━━━━╮
+│ ▒█▀▀▀ █░░ █▀▀█ █▀▀ █░█ │
+│ ▒█▀▀▀ █░░ █░░█ █░░ █▀▄ │
+│ ▒█░░░ ▀▀▀ ▀▀▀▀ ▀▀▀ ▀░▀ │
+╰━━━━━━━━━━━━━━━━━━━━━━━━╯
+🦆     🐤    🐧     🐓
+""",
+        justify="center",
+        style="bold orange3",
+    )
+    console.print(banner_text)
+    console.print(f"[bold]white duck GmbH[/] - [cyan]https://whiteduck.de[/]\n")

{flock_core-0.2.17.dist-info → flock_core-0.2.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.2.17
+Version: 0.2.18
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE
@@ -38,7 +38,7 @@ Requires-Dist: tavily-python>=0.5.0; extra == 'tools'
 Description-Content-Type: text/markdown
 
 <p align="center">
-<img src="docs/img/flock.png" width="600"><br>
+<img src="docs/assets/images/flock.png" width="600"><br>
 <img alt="Dynamic TOML Badge" src="https://img.shields.io/badge/dynamic/toml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fwhiteducksoftware%2Fflock%2Frefs%2Fheads%2Fmaster%2Fpyproject.toml&query=%24.project.version&style=for-the-badge&logo=pypi&label=pip%20version">
 <a href="https://www.linkedin.com/company/whiteduck" target="_blank"><img alt="LinkedIn" src="https://img.shields.io/badge/linkedin-%230077B5.svg?style=for-the-badge&logo=linkedin&logoColor=white&label=whiteduck"></a>
 <a href="https://bsky.app/profile/whiteduck-gmbh.bsky.social" target="_blank"><img alt="Bluesky" src="https://img.shields.io/badge/bluesky-Follow-blue?style=for-the-badge&logo=bluesky&logoColor=%23fff&color=%23333&labelColor=%230285FF&label=whiteduck-gmbh"></a>
@@ -69,7 +69,15 @@ Flock is a framework for orchestrating LLM-powered agents. It leverages a **decl
 
 https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
+## Table of Contents
 
+- [Key Innovations](#key-innovations)
+- [Examples](#examples)
+  - [Hello Flock!](#hello-flock)
+  - [It's not my type](#its-not-my-type)
+  - [Being pydantic](#being-pydantic)
+  - [Building a chain gang!](#building-a-chain-gang)
+- [Installation](#installation)
 
 
 ## Key Innovations
@@ -96,7 +104,7 @@ https://github.com/user-attachments/assets/bdab4786-d532-459f-806a-024727164dcc
 
 
 <p align="center">
-<img src="docs/img/flock_cli.png" width="200"><br>
+<img src="docs/assets/images//flock_cli.png" width="200"><br>
 
 ## Examples
 
@@ -294,6 +302,58 @@ And BAM! Your finished data model filled up to the brim with data! 🎊
 }
 ```
 
+### Building a chain gang
+
+Our `bloggy` is great, but what if we want to turn those amazing headers into full blog posts? Time to bring in a friend! 🤝
+Let's see how easy it is to make agents work together 🔗
+
+```python
+from flock.core import Flock, FlockAgent
+
+flock = Flock(model="openai/gpt-4o")
+
+# First agent: Our trusty bloggy generates titles and headers! 📝
+bloggy = FlockAgent(
+    name="bloggy",
+    input="blog_idea: str|The topic to blog about",
+    output=(
+        "funny_blog_title: str|A catchy title for the blog, "
+        "blog_headers: list[str]|List of section headers for the blog"
+    )
+)
+
+# Second agent: The content wizard that brings headers to life! ✨
+content_writer = FlockAgent(
+    name="content_writer",
+    input=(
+        "funny_blog_title: str|The blog title to work with, "
+        "blog_headers: list[str]|The headers to expand into content"
+    ),
+    output="blog_sections: list[BlogSection]|The fully written blog sections"
+)
+
+# Make them besties! 🤝
+bloggy.hand_off = content_writer
+
+# Add your dynamic duo to the flock
+flock.add_agent(bloggy)
+flock.add_agent(content_writer)
+
+# Let them create some magic! 🎨
+result = flock.run(
+    input={"blog_idea": "A blog about cats"},
+    start_agent=bloggy
+)
+```
+
+Super simple rules to remember:
+1. Point the first agent to the next one using `hand_off`
+2. Make sure their inputs and outputs match up
+
+That's all there is to it! `bloggy` comes up with amazing headers, and `content_writer` turns them into full blog sections. No more writer's block! 🎉
+
+And this is just the beginning - you can chain as many agents as you want. Maybe add a proofreader? Or an SEO optimizer? But let's not get ahead of ourselves! 😉
+
 So far we've barely scratched the surface of what flock has to offer, and we're currently hard at work building up the documentation for all the other super cool features Flock has up its sleeve! Stay tuned! 🚀
 
 ## Temporal Workflow Integration
@@ -308,7 +368,9 @@ Documentation in progress!
 
 ## Architecture
 
-Documentation in progress!
+<img src="docs/assets/images/components_chart.png" width="800"><br>
+
+<img src="docs/assets/images/flow_chart.png" width="800"><br>
 
 
 ## Requirements

{flock_core-0.2.17.dist-info → flock_core-0.2.18.dist-info}/RECORD

@@ -32,7 +32,7 @@ flock/core/mixin/prompt_parser.py,sha256=eOqI-FK3y17gVqpc_y5GF-WmK1Jv8mFlkZxTcgw
 flock/core/registry/agent_registry.py,sha256=YkYIyvFNjm7gYKRAiQQdOvVYMtsYH5cijfrv_GP4ZHc,4889
 flock/core/tools/basic_tools.py,sha256=OwWaFu4NoVrc3Uijj56RY9XDDaP_mOnEa5B3wSWwwLE,4756
 flock/core/tools/dev_tools/github.py,sha256=a2OTPXS7kWOVA4zrZHynQDcsmEi4Pac5MfSjQOLePzA,5308
-flock/core/util/cli_helper.py,sha256=nlSnPrc1pnYEFQXcL_wCqPI6g1Jr7AzNtmGoOPs0zKw,936
+flock/core/util/cli_helper.py,sha256=oJGbVaOolMKpXWqWKuT4VJUjyFnlUgHxtGyeK0IDJFg,1644
 flock/core/util/hydrator.py,sha256=6qNwOwCZB7r6y25BZ--0PGofrAlfMaXbDKFQeP5NLts,11196
 flock/core/util/input_resolver.py,sha256=g9vDPdY4OH-G7qjas5ksGEHueokHGFPMoLOvC-ngeLo,5984
 flock/core/util/serializable.py,sha256=SymJ0YrjBx48mOBItYSqoRpKuzIc4vKWRS6ScTzre7s,2573
@@ -380,8 +380,8 @@ flock/workflow/activities.py,sha256=2zcYyDoCuYs9oQbnhLjCzBUdEi7d5IEIemKJ7TV_B8w,
 flock/workflow/agent_activities.py,sha256=NhBZscflEf2IMfSRa_pBM_TRP7uVEF_O0ROvWZ33eDc,963
 flock/workflow/temporal_setup.py,sha256=VWBgmBgfTBjwM5ruS_dVpA5AVxx6EZ7oFPGw4j3m0l0,1091
 flock/workflow/workflow.py,sha256=I9MryXW_bqYVTHx-nl2epbTqeRy27CAWHHA7ZZA0nAk,1696
-flock_core-0.2.17.dist-info/METADATA,sha256=uluO8ie9LjTnlmLXTdaNTvanGOE-tsIcGdYB-tPKJjk,16930
-flock_core-0.2.17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-flock_core-0.2.17.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
-flock_core-0.2.17.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
-flock_core-0.2.17.dist-info/RECORD,,
+flock_core-0.2.18.dist-info/METADATA,sha256=GG1FxcQ-Bh96SEo-dQvASbumhdiaAoBh7zNpYYKtgrM,19050
+flock_core-0.2.18.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+flock_core-0.2.18.dist-info/entry_points.txt,sha256=rWaS5KSpkTmWySURGFZk6PhbJ87TmvcFQDi2uzjlagQ,37
+flock_core-0.2.18.dist-info/licenses/LICENSE,sha256=iYEqWy0wjULzM9GAERaybP4LBiPeu7Z1NEliLUdJKSc,1072
+flock_core-0.2.18.dist-info/RECORD,,