versionhq 1.1.12.1__py3-none-any.whl → 1.1.12.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. versionhq/__init__.py +48 -6
  2. versionhq/_utils/__init__.py +3 -0
  3. versionhq/agent/inhouse_agents.py +14 -4
  4. versionhq/agent/model.py +1 -2
  5. versionhq/agent/rpm_controller.py +1 -1
  6. versionhq/clients/product/model.py +0 -1
  7. versionhq/knowledge/__init__.py +22 -0
  8. versionhq/knowledge/model.py +0 -2
  9. versionhq/knowledge/source.py +0 -1
  10. versionhq/memory/model.py +109 -47
  11. versionhq/storage/ltm_sqlite_storage.py +29 -43
  12. versionhq/storage/mem0_storage.py +1 -1
  13. versionhq/storage/rag_storage.py +23 -22
  14. versionhq/storage/task_output_storage.py +6 -6
  15. versionhq/task/TEMPLATES/Description.py +3 -3
  16. versionhq/task/__init__.py +0 -9
  17. versionhq/task/evaluate.py +16 -3
  18. versionhq/task/formation.py +114 -0
  19. versionhq/task/model.py +51 -78
  20. versionhq/task/structured_response.py +1 -1
  21. versionhq/team/model.py +27 -46
  22. versionhq/team/team_planner.py +5 -2
  23. versionhq/tool/model.py +1 -1
  24. {versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/METADATA +28 -15
  25. {versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/RECORD +28 -27
  26. {versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/LICENSE +0 -0
  27. {versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/WHEEL +0 -0
  28. {versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/top_level.txt +0 -0
{versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/METADATA RENAMED
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.2
2
2
  Name: versionhq
3
- Version: 1.1.12.1
4
- Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
3
+ Version: 1.1.12.3
4
+ Summary: An agentic orchestration framework for multi-agent system that shares memory, knowledge base, and RAG tools.
5
5
  Author-email: Kuriko Iwai <kuriko@versi0n.io>
6
6
  License: MIT License
7
7
 
@@ -29,7 +29,7 @@ Project-URL: Homepage, https://versi0n.io
29
29
  Project-URL: Documentation, https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=73
30
30
  Project-URL: Repository, https://github.com/versionHQ/multi-agent-system
31
31
  Project-URL: Issues, https://github.com/versionHQ/multi-agent-system/issues
32
- Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,agent
32
+ Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,agent,agentic orchestration,llm
33
33
  Classifier: Programming Language :: Python
34
34
  Classifier: Programming Language :: Python :: 3
35
35
  Classifier: Programming Language :: Python :: 3.11
@@ -63,6 +63,7 @@ Requires-Dist: composio-langchain>=0.6.12
63
63
  Requires-Dist: chromadb>=0.6.3
64
64
  Requires-Dist: wheel>=0.45.1
65
65
  Requires-Dist: envoy>=0.0.3
66
+ Requires-Dist: composio-core==0.7.0
66
67
  Provides-Extra: docling
67
68
  Requires-Dist: docling>=2.17.0; extra == "docling"
68
69
  Provides-Extra: mem0ai
@@ -83,7 +84,7 @@ Requires-Dist: numpy>=1.26.4; extra == "numpy"
83
84
  ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
84
85
 
85
86
 
86
- LLM orchestration frameworks to deploy multi-agent systems and automate complex tasks with network formations.
87
+ Agentic orchestration framework to deploy agent network and handle complex task automation.
87
88
 
88
89
  **Visit:**
89
90
 
@@ -102,9 +103,10 @@ LLM orchestration frameworks to deploy multi-agent systems and automate complex
102
103
  - [Key Features](#key-features)
103
104
  - [Agent formation](#agent-formation)
104
105
  - [Quick Start](#quick-start)
105
- - [Case 1. Solo Agent:](#case-1-solo-agent)
106
+ - [Generate agent networks and launch task execution:](#generate-agent-networks-and-launch-task-execution)
107
+ - [Solo Agent:](#solo-agent)
106
108
  - [Return a structured output with a summary in string.](#return-a-structured-output-with-a-summary-in-string)
107
- - [Case 2. Supervising:](#case-2-supervising)
109
+ - [Supervising:](#supervising)
108
110
  - [Technologies Used](#technologies-used)
109
111
  - [Project Structure](#project-structure)
110
112
  - [Setup](#setup)
@@ -122,9 +124,9 @@ LLM orchestration frameworks to deploy multi-agent systems and automate complex
122
124
 
123
125
  ## Key Features
124
126
 
125
- Generate multi-agent systems based on the task complexity, execute tasks, and evaluate output based on the given criteria.
127
+ `versionhq` is a Python framework that can generate agent networks for complex task automation without human interaction.
126
128
 
127
- Agents are model-agnostic, and can handle and share RAG tools, knowledge, memory, and callbacks among other agents. (self-learn)
129
+ Agents are model-agnostic, and will improve task output, while oprimizing token cost and job latency, by sharing their memory, knowledge base, and RAG tools with other agents in the network.
128
130
 
129
131
 
130
132
  ### Agent formation
@@ -152,15 +154,28 @@ You can specify a desired formation or allow the agents to determine it autonomo
152
154
 
153
155
  (Python 3.11 or higher)
154
156
 
157
+ ### Generate agent networks and launch task execution:
155
158
 
156
- ### Case 1. Solo Agent:
159
+ ```
160
+ from versionhq import form_agent_network
161
+
162
+ network = form_agent_network(
163
+ task="YOUR AMAZING TASK OVERVIEW",
164
+ expected_outcome="YOUR OUTCOME EXPECTATION",
165
+ )
166
+ res = network.launch()
167
+ ```
168
+
169
+ This will form a network with multiple agents on `Formation` and return `TaskOutput` object with output in JSON, plane text, Pydantic model format with evaluation.
170
+
171
+
172
+ ### Solo Agent:
157
173
 
158
174
  #### Return a structured output with a summary in string.
159
175
 
160
176
  ```
161
177
  from pydantic import BaseModel
162
- from versionhq.agent.model import Agent
163
- from versionhq.task.model import Task
178
+ from versionhq import Agent, Task
164
179
 
165
180
  class CustomOutput(BaseModel):
166
181
  test1: str
@@ -197,12 +212,10 @@ This will return `TaskOutput` instance that stores a response in plane text, JSO
197
212
  )
198
213
  ```
199
214
 
200
- ### Case 2. Supervising:
215
+ ### Supervising:
201
216
 
202
217
  ```
203
- from versionhq.agent.model import Agent
204
- from versionhq.task.model import Task, ResponseField
205
- from versionhq.team.model import Team, TeamMember
218
+ from versionhq import Agent, Task, ResponseField, Team, TeamMember
206
219
 
207
220
  agent_a = Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
208
221
  agent_b = Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
{versionhq-1.1.12.1.dist-info → versionhq-1.1.12.3.dist-info}/RECORD RENAMED
@@ -1,15 +1,15 @@
1
- versionhq/__init__.py,sha256=oJDsufVGH28Hszr45GDKyjfs_OKDZaNrAhMOS4f9RmY,1031
2
- versionhq/_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
1
+ versionhq/__init__.py,sha256=7tNLp19NRK1hbonxLY-MD1XLsbs28PwWCnxX9vaXM9A,2349
2
+ versionhq/_utils/__init__.py,sha256=dzoZr4cBlh-2QZuPzTdehPUCe9lP1dmRtauD7qTjUaA,158
3
3
  versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
4
4
  versionhq/_utils/logger.py,sha256=j9SlQPIefdVUlwpGfJY83E2BUt1ejWgZ2M2I8aMyQ3c,1579
5
5
  versionhq/_utils/process_config.py,sha256=jbPGXK2Kb4iyCugJ3FwRJuU0wL5Trq2x4xFQz2uOyFY,746
6
6
  versionhq/_utils/usage_metrics.py,sha256=hhq1OCW8Z4V93vwW2O2j528EyjOlF8wlTsX5IL-7asA,1106
7
7
  versionhq/_utils/vars.py,sha256=bZ5Dx_bFKlt3hi4-NNGXqdk7B23If_WaTIju2fiTyPQ,57
8
8
  versionhq/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
9
- versionhq/agent/inhouse_agents.py,sha256=DLwSREmFICF0Wv9IvEXp0gu1yOXJYOex0980Vi0NRWw,913
10
- versionhq/agent/model.py,sha256=1Y5au6ue6B4UbtoBL00kVATbl_0_IzY_-SBkuzVvL94,22423
9
+ versionhq/agent/inhouse_agents.py,sha256=v8frZjmiqYR8zuuh4CjYJheaHfHT2n_utT8pWCLJFes,2375
10
+ versionhq/agent/model.py,sha256=w58WIwIOI_gBlRHVlkU07ILVRlBSSJnpqWhzx0TU8d0,22416
11
11
  versionhq/agent/parser.py,sha256=riG0dkdQCxH7uJ0AbdVdg7WvL0BXhUgJht0VtQvxJBc,4082
12
- versionhq/agent/rpm_controller.py,sha256=7AKIEPbWBq_ESOZCaiKVOGjfSPHd2qwg6-wbBlhqC0g,2367
12
+ versionhq/agent/rpm_controller.py,sha256=grezIxyBci_lDlwAlgWFRyR5KOocXeOhYkgN02dNFNE,2360
13
13
  versionhq/agent/TEMPLATES/Backstory.py,sha256=IAhGnnt6VUMe3wO6IzeyZPDNu7XE7Uiu3VEXUreOcKs,532
14
14
  versionhq/agent/TEMPLATES/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
15
15
  versionhq/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -17,14 +17,14 @@ versionhq/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
17
17
  versionhq/clients/customer/__init__.py,sha256=-YXh1FQfvpfLacK8SUC7bD7Wx_eIEi4yrkCC_cUasFg,217
18
18
  versionhq/clients/customer/model.py,sha256=_AtaVVMm9MgCwrQ-HTRQ2oXUMKrSCEfZwE2JdRz3xTw,2508
19
19
  versionhq/clients/product/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
20
- versionhq/clients/product/model.py,sha256=hLTvvQsatNuq0DtyTqpP_gRKgnv6N4uRjavnGfk7b6Y,3695
20
+ versionhq/clients/product/model.py,sha256=3w__pug9XRe4LIm9wX8C8WKqi40r081Eb1q2vWk9UaU,3694
21
21
  versionhq/clients/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
22
22
  versionhq/clients/workflow/model.py,sha256=FNftenLLoha0bkivrjId32awLHAkBwIT8iNljdic_bw,6003
23
- versionhq/knowledge/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
23
+ versionhq/knowledge/__init__.py,sha256=qW7IgssTA4_bFFV9ziOcYRfGjlq1c8bkb-HnfWknpuQ,567
24
24
  versionhq/knowledge/_utils.py,sha256=YWRF8U533cfZes_gZqUvdj-K24MD2ri1R0gjc_aPYyc,402
25
25
  versionhq/knowledge/embedding.py,sha256=KfHc__1THxb5jrg1EMrF-v944RDuIr2hE0l-MtM3Bp0,6826
26
- versionhq/knowledge/model.py,sha256=n7kU4jQ24BUIxwosSVRK8tYhAFYhgc4yf7e4Q-bq4bk,1832
27
- versionhq/knowledge/source.py,sha256=WOARChmm_cNtBD-xGo4RoYmcuodzdalctXI-gDBCW6k,13610
26
+ versionhq/knowledge/model.py,sha256=w29mrJv1kiznCh4P4yJMUQxIuyRw1Sk0XYtBXzCxaG4,1786
27
+ versionhq/knowledge/source.py,sha256=30VXsl3uHdM0wK0Dik3XfFxpNpEiy539PBNBvg0Y4-g,13609
28
28
  versionhq/knowledge/source_docling.py,sha256=hhHn3rS4KVsFKEPWcfllM8VxSL86PckZdAHDZNQNOq8,5411
29
29
  versionhq/knowledge/storage.py,sha256=7oxCg3W9mFjYH1YmuH9kFtTbNxquzYFjuUjd_TlsB9E,8170
30
30
  versionhq/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -32,33 +32,34 @@ versionhq/llm/llm_vars.py,sha256=asJtkKCcD0WWIbyVn7CYOWg-WZ6MSKS9lIRaYIkdib4,677
32
32
  versionhq/llm/model.py,sha256=wSjRGyk9AZtvDqNfcyyeOMoV_hpTaUHCM849hBF0MhU,15145
33
33
  versionhq/memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
34
34
  versionhq/memory/contextual_memory.py,sha256=tCsOOAUnfrOL7YiakqGoi3uShzzS870TmGnlGd3z_A4,3556
35
- versionhq/memory/model.py,sha256=6Sy-cnrhHNIx3ZN38uNO7d8YywIl_uo_OvDVzVM-w14,5755
35
+ versionhq/memory/model.py,sha256=4wow2O3UuMZ0AbC2NyxddGZac3-_GjNZbK9wsA015NA,8145
36
36
  versionhq/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
37
37
  versionhq/storage/base.py,sha256=p-Jas0fXQan_qotnRD6seQxrT2lj-uw9-SmHQhdppcs,355
38
- versionhq/storage/ltm_sqlite_storage.py,sha256=LMitExpDATg__Oc7Hvl6h6uwQ7vUKQ34Eyp1BSt0DfY,4260
39
- versionhq/storage/mem0_storage.py,sha256=iWYXJdFUnahwWAddDl2L4cNTaUkCx3lIzexm6cABBa4,3802
40
- versionhq/storage/rag_storage.py,sha256=fBk-RJuFRPOH4gI9E67tkhJnTBoChWocSP2PdWUYIFg,7313
41
- versionhq/storage/task_output_storage.py,sha256=gCsZywZ2SaNA1pYIsJk6BTrcpGp79TZTviZkWQF5USs,4579
38
+ versionhq/storage/ltm_sqlite_storage.py,sha256=wdUiuwHfJocdk0UGqyrdU4S5Nae1rgsoRNu3LWmGFcI,3951
39
+ versionhq/storage/mem0_storage.py,sha256=Nl0GlCNftZGTVxX-9DP5n_pN4QRxeHAhAPakCc0arBg,3819
40
+ versionhq/storage/rag_storage.py,sha256=ScWC0vH327vnGw8UGscAOoIfqrq3mhvXT3vEKzHZJts,7441
41
+ versionhq/storage/task_output_storage.py,sha256=E1t_Fkt78dPYIOl3MP7LfQ8oGtjlzxBuSNq_8ZXKho8,4573
42
42
  versionhq/storage/utils.py,sha256=ByYXPoEIGJYLUqz-DWjbCAnneNrH1otiYbp12SCILpM,747
43
- versionhq/task/__init__.py,sha256=l2r_g01i91JAGlOoHZP_Gh2WCk6mo9D19lcqt7sKMpQ,186
44
- versionhq/task/evaluate.py,sha256=sG_PFotpuRbDLW0rGDULseBk1uP8I0vYYtkh1npO0KE,3374
43
+ versionhq/task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
44
+ versionhq/task/evaluate.py,sha256=f8S-nuEl2xJ2LnLv7iQixH53-gp0pKx1hFp_sUlN464,3977
45
+ versionhq/task/formation.py,sha256=bZytru6I5a_CFq2rtmsBb0hVWIqExpzUxXPXYpd6qnI,4706
45
46
  versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
46
47
  versionhq/task/log_handler.py,sha256=KJRrcNZgFSKhlNzvtYFnvtp6xukaF1s7ifX9u4zWrN8,1683
47
- versionhq/task/model.py,sha256=kR4oqoT44xVbbTGK-gtVdfMz3m-riV62XumzRyqomiU,30418
48
- versionhq/task/structured_response.py,sha256=YxuWcDMHcZLzdxI1ihW99Y-i6nl8yXBQ5Q_dFQac8jw,4837
49
- versionhq/task/TEMPLATES/Description.py,sha256=bChflSWGGQo9JpnO6QX6Ng9pnONiTf-zwQ3ke4xQgSQ,357
48
+ versionhq/task/model.py,sha256=2p3Fc4iphfAjARaClFL3AXDg_203Kx6VAlMgt2-L29U,29444
49
+ versionhq/task/structured_response.py,sha256=uVqgeUxNOACPe2hdc0RELSbtKd1vrwonfjXMOGTT0TI,4818
50
+ versionhq/task/TEMPLATES/Description.py,sha256=V-4kh8xpQTKOcDMi2xnuP-fcNk6kuoz1_5tYBlDLQWQ,420
50
51
  versionhq/team/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
51
- versionhq/team/model.py,sha256=MgjqigmEDLnmDzYfVnbGnwp7MeXmZ-zsgyWR2Vb2FAU,20036
52
- versionhq/team/team_planner.py,sha256=UyIpw7GoRQXlgLNaojoi-G8F1sYaf5hTpLcTvWjRvlA,3596
52
+ versionhq/team/model.py,sha256=WDnaJuvnVMmreztR0CMypnKpqFtGzAb7rrZ-HKa010Y,18886
53
+ versionhq/team/team_planner.py,sha256=l1PwyBXK1F3uOcbF1IvJBWKApJhghZnBF_ErkNcE04s,3745
53
54
  versionhq/tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
54
55
  versionhq/tool/cache_handler.py,sha256=iL8FH7X0G-cdT0uhJwzuhLDaadTXOdfybZcDy151-es,1085
55
56
  versionhq/tool/composio_tool.py,sha256=38mEiVvTkuw1BLD233Bl1Gwxbpss1yfQiZLTWwX6BdA,8648
56
57
  versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtgpqOzKZQ,1843
57
58
  versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
58
- versionhq/tool/model.py,sha256=7ccEnje_8LuxLVeog6pL38nToArXQXk4KY7A9hfprDo,12239
59
+ versionhq/tool/model.py,sha256=ILfvRviQR1W1w-u3MtOIz0PrWa-brpgfAiyKWol63mk,12227
59
60
  versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
60
- versionhq-1.1.12.1.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
61
- versionhq-1.1.12.1.dist-info/METADATA,sha256=rPZzAQlTUGo_Fh7FUyQFBELbuzxAOqnC9b83z-qvv20,18694
62
- versionhq-1.1.12.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
63
- versionhq-1.1.12.1.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
64
- versionhq-1.1.12.1.dist-info/RECORD,,
61
+ versionhq-1.1.12.3.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
62
+ versionhq-1.1.12.3.dist-info/METADATA,sha256=yF8JpWAlDcWmJ9gxaZzZ-Tm3YZlxIzMblGHhBwerqms,19184
63
+ versionhq-1.1.12.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
64
+ versionhq-1.1.12.3.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
65
+ versionhq-1.1.12.3.dist-info/RECORD,,