versionhq 1.1.10.6__py3-none-any.whl → 1.1.10.8__py3-none-any.whl

versionhq/__init__.py

@@ -18,7 +18,7 @@ from versionhq.tool.model import Tool
 from versionhq.tool.composio_tool import ComposioHandler
 
 
-__version__ = "1.1.10.6"
+__version__ = "1.1.10.8"
 __all__ = [
     "Agent",
     "Customer",

{versionhq-1.1.10.6.dist-info → versionhq-1.1.10.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.10.6
+Version: 1.1.10.8
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -66,31 +66,16 @@ Requires-Dist: composio-langchain>=0.6.12
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
-An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
-
-Agents are model agnostic.
-
-Messaging workflows are created at individual level, and will be deployed on third-party services via `Composio`.
-
+LLM orchestration frameworks to deploy multi-agent systems focusing on complex outbound tasks.
 
 **Visit:**
 
 - [PyPI](https://pypi.org/project/versionhq/)
-- [Github (LLM orchestration)](https://github.com/versionHQ/multi-agent-system)
-- [Doc](https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=4)
-<!-- - [Github (Test client app)](https://github.com/versionHQ/test-client-app) -->
-- [Use case](https://versi0n.io/): Client web app for the outbound messaging automation
-
-
-<hr />
+- [Github (LLM orchestration framework)](https://github.com/versionHQ/multi-agent-system)
+- [Github (Test client app)](https://github.com/versionHQ/test-client-app)
+- [Use case](https://versi0n.io/playground) / [Quick demo](https://res.cloudinary.com/dfeirxlea/video/upload/v1737732977/pj_m_home/pnsyh5mfvmilwgt0eusa.mov)
+- [Documentation](https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=4) *Some components are under review.
 
-## Mindmap
-
-LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete the `task` given by the client or the system.
-
-<p align="center">
-   <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="400">
-</p>
 
 <hr />
 
@@ -99,9 +84,11 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 - [Key Features](#key-features)
-- [Usage](#usage)
-  - [Case 1. Single agent handling task:](#case-1-single-agent-handling-task)
-  - [Case 2. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
+  - [Agent formation](#agent-formation)
+- [Quick Start](#quick-start)
+  - [Case 1. Solo Agent:](#case-1-solo-agent)
+    - [Return a structured output with a summary in string.](#return-a-structured-output-with-a-summary-in-string)
+  - [Case 2. Supervising:](#case-2-supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -119,36 +106,39 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
 
 ## Key Features
 
-A mulit-agent systems with Rag that tailors messaging workflow, predicts its performance, and deploys it on third-party tools.
+Generate mulit-agent systems depending on the complexity of the task, and execute the task with agents of choice.
+
+Model-agnostic agents can handle RAG tools, tools, callbacks, and knowledge sharing among other agents.
 
-The `agent` is model agnostic. The default model is set Chat GTP 4o. We ask the client their preference and switch it accordingly using llm variable stored in the `BaseAgent` class.
 
-Multiple `agents` can form a `team` to complete complex tasks together.
+###  Agent formation
+Depending on the task complexity, agents can make a different formation.
 
-**1. Analysis**
-- Professional `agents` handle the analysis `tasks` on each client, customer, and product.
+You can specify which formation you want them to generate, or let the agent decide if you don’t have a clear plan.
 
-**2. Messaging Workflow Creation**
-- Several `teams` receive the analysis and design initial messaging workflow with several layers.
-- Ask the client for their inputs
-- Deploy the workflow on the third party tools using `composio`.
 
-**3. Autopiloting**
-- Responsible `agents` or `teams` autopilot executing and refining the messaging workflow.
+|  | **Solo Agent** | **Supervising** | **Network** | **Random** |
+| :--- | :--- | :--- | :--- | :--- |
+| **Formation** | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1737893140/pj_m_agents/tglrxoiuv7kk7nzvpe1z.jpg" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1737893141/pj_m_agents/hxngdvnn5b5qdxo0ayl5.jpg" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1737893142/pj_m_agents/kyc6neg8m6keyizszcpi.jpg" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1737893139/pj_m_agents/hzpchlcpnpwxwaapu1hr.jpg" alt="solo" width="200"> |
+| **Usage** | <ul><li>A single agent with tools, knowledge, and memory.</li><li>When self-learning mode is on - it will turn into **Random** formation.</li></ul> | <ul><li>Leader agent gives directions, while sharing its knowledge and memory.</li><li>Subordinates can be solo agents or networks.</li></ul> | <ul><li>Share tasks, knowledge, and memory among network members.</li></ul> | <ul><li>A single agent handles tasks, asking help from other agents without sharing its memory or knowledge.</li></ul> |
+| **Use case** | An email agent drafts promo message for the given audience. | The leader agent strategizes an outbound campaign plan and assigns components such as media mix or message creation to subordinate agents. | An email agent and social media agent share the product knowledge and deploy multi-channel outbound campaign. | 1. An email agent drafts promo message for the given audience, asking insights on tones from other email agents which oversee other clusters. 2. An agent calls the external agent to deploy the campaign. |
 
 <hr />
 
-## Usage
+## Quick Start
+
+**Install `versionhq` package:**
 
-1. Install `versionhq` package:
    ```
    pip install versionhq
    ```
 
-2. You can use the `versionhq` module in your Python app.
+(Python >= 3.13)
+
 
+### Case 1. Solo Agent:
 
-### Case 1. Single agent handling task:
+#### Return a structured output with a summary in string.
 
    ```
    from pydantic import BaseModel
@@ -176,7 +166,7 @@ Multiple `agents` can form a `team` to complete complex tasks together.
    print(res)
    ```
 
-This will return a `TaskOutput` instance with response in raw, JSON dict, and Pydantic model: `CustomOutput` formats with a callback result.
+This will return `TaskOutput` that stores a response in string, JSON dict, and Pydantic model: `CustomOutput` formats with a callback result.
 
    ```
    res == TaskOutput(
@@ -187,7 +177,7 @@ This will return a `TaskOutput` instance with response in raw, JSON dict, and Py
    )
    ```
 
-### Case 2. Form a team to handle multiple tasks:
+### Case 2. Supervising:
 
    ```
    from versionhq.agent.model import Agent
@@ -222,7 +212,6 @@ This will return a list with dictionaries with keys defined in the `ResponseFiel
 
 Tasks can be delegated to a team manager, peers in the team, or completely new agent.
 
-
 <hr />
 
 ## Technologies Used

{versionhq-1.1.10.6.dist-info → versionhq-1.1.10.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-versionhq/__init__.py,sha256=RKe1lkTyJ8IrVi0_DCbvRYnfeST79MLz1SIdplZIgdA,951
+versionhq/__init__.py,sha256=pry2Yt_k40q8nWxPZKz5VXQuVsdZV1fpGbQydJZPQqM,951
 versionhq/_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
 versionhq/_utils/logger.py,sha256=U-MpeGueA6YS8Ptfy0VnU_ePsZP-8Pvkvi0tZ4s_UMg,1438
@@ -38,8 +38,8 @@ versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtg
 versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
 versionhq/tool/model.py,sha256=5qG-OH7zohvepPDOjdjDulhEqmNUM4osiyk5LaxmSiU,12333
 versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
-versionhq-1.1.10.6.dist-info/LICENSE,sha256=7CCXuMrAjPVsUvZrsBq9DsxI2rLDUSYXR_qj4yO_ZII,1077
-versionhq-1.1.10.6.dist-info/METADATA,sha256=V-Ld6P_xDdRfK2HQGcbCuPS8FeyoRX2seXFy0v_UX4g,16535
-versionhq-1.1.10.6.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-versionhq-1.1.10.6.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.1.10.6.dist-info/RECORD,,
+versionhq-1.1.10.8.dist-info/LICENSE,sha256=7CCXuMrAjPVsUvZrsBq9DsxI2rLDUSYXR_qj4yO_ZII,1077
+versionhq-1.1.10.8.dist-info/METADATA,sha256=bzzK5JgKF1HH3FwiTTFnQggDkpa6k7_swpaTMegeoE0,17571
+versionhq-1.1.10.8.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+versionhq-1.1.10.8.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.1.10.8.dist-info/RECORD,,