flock-core 0.3.4__tar.gz → 0.3.5__tar.gz

{flock_core-0.3.4 → flock_core-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flock-core
-Version: 0.3.4
+Version: 0.3.5
 Summary: Declarative LLM Orchestration at Scale
 Author-email: Andre Ratzenberger <andre.ratzenberger@whiteduck.de>
 License-File: LICENSE
@@ -35,6 +35,7 @@ Requires-Dist: temporalio>=1.9.0
 Requires-Dist: tiktoken>=0.8.0
 Requires-Dist: toml>=0.10.2
 Requires-Dist: tqdm>=4.67.1
+Requires-Dist: uvicorn>=0.34.0
 Requires-Dist: zep-python>=2.0.2
 Provides-Extra: all-tools
 Requires-Dist: docling>=2.18.0; extra == 'all-tools'

flock_core-0.3.5/docs/core-concepts/evaluators.md

@@ -0,0 +1 @@
+# Evaluators

flock_core-0.3.5/docs/core-concepts/modules.md

@@ -0,0 +1 @@
+# Modules

{flock_core-0.3.4 → flock_core-0.3.5}/docs/getting-started/quickstart.md

@@ -68,7 +68,7 @@ flock = Flock(
 )
 
 # Meet your new AI friend
-bloggy = FlockAgent(
+bloggy = FlockFactory.create_default_agent(
     name="bloggy",
     input="topic",
     output="catchy_title, blog_headers"
@@ -106,12 +106,13 @@ Let's break down the magic:
 
 2. **Creating Your First Agent**:
    ```python
-   bloggy = FlockAgent(
+   bloggy = FlockFactory.create_default_agent(
         name="bloggy",
         input="topic",
         output="catchy_title, blog_headers"
     )
    ```
+   The FlockFactory is churning out your agents.
    Think of this as defining your agent's job description - what they need and what they'll create.
 
 3. **Action Time!**:
@@ -149,7 +150,7 @@ Also the agent itself offers a description field.
 
 ```python
 # Your agent just got an upgrade!
-bloggy = FlockAgent(
+bloggy = FlockFactory.create_default_agent(
             name="bloggy",
             input="topic",
             description="Bloggy creates fun blog outlines for any given topic",

{flock_core-0.3.4 → flock_core-0.3.5}/examples/01_introduction/04_descriptions.py

@@ -1,14 +1,3 @@
-"""
-Title: Getting into the details with descriptions
-
-Perhaps your co-worker who loves writing blog post long prompts for his agents thought he has found an out:
-"Due to my long prompts I can make my agents do anything I want, which is not possible with your little declarative flocky!" he proclaimed.
-"What do you do when you need your agents to handle edge cases?" he asked. 
-
-You, being the flocky expert, decided to show him how to use 'descriptions' to make your agents do anything his agents can do and more.
-"""
-
-
 from flock.core import Flock, FlockFactory
  
 flock = Flock()

{flock_core-0.3.4 → flock_core-0.3.5}/examples/01_introduction/05_typed_output2.py

@@ -1,21 +1,3 @@
-"""
-Title: Random User List Generator with Data Class Integration and Caching
-
-In this example, you'll see a simple Flock agent in action that generates a list of random users.
-This example demonstrates several cool features:
-  - **Data Class Integration:** We define a `RandomPerson` dataclass to structure the random user data.
-  - **Caching:** Enabled caching ensures that if you run the agent with the same input,
-    it will return a cached result—ideal for speeding up repeated requests.
-  - **Simple Agent Declaration:** Like all Flock agents, this one declares what it needs 
-    ("amount_of_people") and what it produces ("random_user_list: list[RandomPerson]") 
-    without the hassle of prompt engineering.
-
-In this scenario, our agent ("people_agent") takes the number of people to generate as input,
-and returns a list of randomly generated users. We then print the number of generated users.
-Let's see how it's done!
-"""
-
-
 from dataclasses import dataclass
 from pprint import pprint
 from typing import Literal

flock_core-0.3.5/examples/01_introduction/06_simple_hand_off.py

@@ -0,0 +1,31 @@
+from flock.core import Flock, FlockFactory
+
+
+
+flock = Flock()
+
+idea_agent = FlockFactory.create_default_agent(
+    name="idea_agent",
+    input="query",
+    output="a_fun_software_project_idea",
+    enable_rich_tables=True,
+    wait_for_input=True,
+)
+
+project_plan_agent = FlockFactory.create_default_agent(
+    name="project_plan_agent",
+    input="a_fun_software_project_idea",
+    output="catchy_project_name, project_pitch, techstack, project_implementation_plan",
+    enable_rich_tables=True,
+    wait_for_input=True,
+)
+
+idea_agent.hand_off = project_plan_agent
+
+flock.run(
+    input={"query": "fun software project idea about ducks"},
+    start_agent=idea_agent,
+    agents=[idea_agent,project_plan_agent]
+)
+
+

{flock_core-0.3.4 → flock_core-0.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "flock-core"
-version = "0.3.4"
+version = "0.3.5"
 description = "Declarative LLM Orchestration at Scale"
 readme = "README.md"
 authors = [
@@ -40,6 +40,7 @@ dependencies = [
     "tiktoken>=0.8.0",
     "toml>=0.10.2",
     "tqdm>=4.67.1",
+    "uvicorn>=0.34.0",
     "zep-python>=2.0.2",
 ]
 

{flock_core-0.3.4 → flock_core-0.3.5}/uv.lock

@@ -1046,7 +1046,7 @@ wheels = [
 
 [[package]]
 name = "flock-core"
-version = "0.3.4"
+version = "0.3.5"
 source = { editable = "." }
 dependencies = [
     { name = "cloudpickle" },
@@ -1076,6 +1076,7 @@ dependencies = [
     { name = "tiktoken" },
     { name = "toml" },
     { name = "tqdm" },
+    { name = "uvicorn" },
     { name = "zep-python" },
 ]
 
@@ -1150,6 +1151,7 @@ requires-dist = [
     { name = "tiktoken", specifier = ">=0.8.0" },
     { name = "toml", specifier = ">=0.10.2" },
     { name = "tqdm", specifier = ">=4.67.1" },
+    { name = "uvicorn", specifier = ">=0.34.0" },
     { name = "zep-python", specifier = ">=2.0.2" },
 ]
 provides-extras = ["all-tools", "tools"]

flock_core-0.3.4/examples/01_introduction/06_simple_hand_off.py

@@ -1,60 +0,0 @@
-"""
-Title: Simple hand-off between two agents
-
-In this example, we create a simple two-agent chain:
-    1. IdeaAgent: Receives a query and outputs a fun software project idea.
-    2. ProjectPlanAgent: Takes the software project idea and outputs a catchy project name, project pitch, tech stack, and project implementation plan.
-
-The IdeaAgent is the starting point of the workflow, and it hands off the software project idea to the ProjectPlanAgent.
-The ProjectPlanAgent then generates additional project details based on the idea.
-
-A more in-depth example of agent hand-off is available in the "a_hand_off_pm.py" example.
-
-To make hand offs between agents as intuitive as possible an agent handoff works by these easy to remember rules:
-
-1. Connect agents by setting the `hand_off` attribute of the first agent to the second agent.
-idea_agent.hand_off = project_plan_agent
-
-2. set the input of the second agent to the output of the first agent (or parts of it).
-idea_agent -> a_fun_software_project_idea -> project_plan_agent
-
-That's it! The agents are now connected and will pass data between them as expected.
-
-For 99% of use cases, this is all you need to do to create a hand-off between agents.
-
-In later examples, we will explore more advanced hand-off scenarios and fall back rules.
-"""
-
-
-
-from flock.core import Flock, FlockFactory
-
-
-
-flock = Flock()
-
-idea_agent = FlockFactory.create_default_agent(
-    name="idea_agent",
-    input="query",
-    output="a_fun_software_project_idea",
-    enable_rich_tables=True,
-    wait_for_input=True,
-)
-
-project_plan_agent = FlockFactory.create_default_agent(
-    name="project_plan_agent",
-    input="a_fun_software_project_idea",
-    output="catchy_project_name, project_pitch, techstack, project_implementation_plan",
-    enable_rich_tables=True,
-    wait_for_input=True,
-)
-
-idea_agent.hand_off = project_plan_agent
-
-flock.run(
-    input={"query": "fun software project idea about ducks"},
-    start_agent=idea_agent,
-    agents=[idea_agent,project_plan_agent]
-)
-
-