versionhq 1.1.6.3__tar.gz → 1.1.6.4__tar.gz
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.
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/PKG-INFO +58 -41
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/README.md +57 -40
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/pyproject.toml +1 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/__init__.py +1 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/agent/model.py +1 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/llm/model.py +1 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq.egg-info/PKG-INFO +58 -41
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq.egg-info/SOURCES.txt +0 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/task/sync_test.py +1 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/team/kickoff_test.py +2 -2
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/uv.lock +1 -1
- versionhq-1.1.6.3/Procfile +0 -1
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.github/workflows/publish.yml +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.github/workflows/publish_testpypi.yml +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.github/workflows/security_check.yml +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.gitignore +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.pre-commit-config.yaml +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/.python-version +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/LICENSE +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/SECURITY.md +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/db/preprocess.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/requirements.txt +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/runtime.txt +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/setup.cfg +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/cache_handler.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/i18n.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/logger.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/process_config.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/rpm_controller.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/_utils/usage_metrics.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/agent/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/agent/parser.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/cli/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/customer/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/customer/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/product/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/product/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/workflow/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/clients/workflow/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/llm/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/llm/llm_vars.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/task/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/task/formatter.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/task/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/team/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/team/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/team/team_planner.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/tool/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/tool/decorator.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/tool/model.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq/tool/tool_handler.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq.egg-info/dependency_links.txt +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq.egg-info/requires.txt +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/src/versionhq.egg-info/top_level.txt +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/cli/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/task/__init__.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/team/Prompts/Demo_test.py +0 -0
- {versionhq-1.1.6.3 → versionhq-1.1.6.4}/tests/team/__init__.py +0 -0
@@ -1,6 +1,6 @@
|
|
1
1
|
Metadata-Version: 2.1
|
2
2
|
Name: versionhq
|
3
|
-
Version: 1.1.6.
|
3
|
+
Version: 1.1.6.4
|
4
4
|
Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
|
5
5
|
Author-email: Kuriko Iwai <kuriko@versi0n.io>
|
6
6
|
License: MIT License
|
@@ -52,7 +52,8 @@ Requires-Dist: wheel>=0.45.1
|
|
52
52
|
|
53
53
|
# Overview
|
54
54
|
|
55
|
-
 
|
56
|
+
 
|
56
57
|
|
57
58
|
|
58
59
|
An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
|
@@ -64,10 +65,10 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
64
65
|
|
65
66
|
**Visit:**
|
66
67
|
|
67
|
-
-
|
68
|
-
- Client app
|
69
|
-
-
|
70
|
-
-
|
68
|
+
- [Landing page](https://home.versi0n.io)
|
69
|
+
- [Client app](https://versi0n.io/)
|
70
|
+
- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
|
71
|
+
- [Test client app](https://github.com/versionHQ/test-client-app)
|
71
72
|
|
72
73
|
|
73
74
|
## Mindmap
|
@@ -75,7 +76,7 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
75
76
|
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.
|
76
77
|
|
77
78
|
<p align="center">
|
78
|
-
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="
|
79
|
+
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="400">
|
79
80
|
</p>
|
80
81
|
|
81
82
|
<hr />
|
@@ -89,8 +90,7 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
|
|
89
90
|
- [Project Structure](#project-structure)
|
90
91
|
- [Setup](#setup)
|
91
92
|
- [Usage](#usage)
|
92
|
-
- [
|
93
|
-
- [Contributing & Customizing](#contributing--customizing)
|
93
|
+
- [Contributing](#contributing)
|
94
94
|
- [Customizing AI Agents](#customizing-ai-agents)
|
95
95
|
- [Modifying RAG Functionality](#modifying-rag-functionality)
|
96
96
|
- [Package Management with uv](#package-management-with-uv)
|
@@ -122,6 +122,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
|
|
122
122
|
- Responsible `agents` or `teams` autopilot executing and refining the messaging workflow.
|
123
123
|
|
124
124
|
|
125
|
+
<hr />
|
126
|
+
|
125
127
|
## Technologies Used
|
126
128
|
**Schema, Database, Data Validation**
|
127
129
|
- [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python
|
@@ -172,6 +174,8 @@ src/
|
|
172
174
|
|
173
175
|
```
|
174
176
|
|
177
|
+
<hr />
|
178
|
+
|
175
179
|
## Setup
|
176
180
|
|
177
181
|
1. Install the `uv` package manager:
|
@@ -204,53 +208,63 @@ src/
|
|
204
208
|
COMPOSIO_CLI_KEY=your-composio-cli-key
|
205
209
|
```
|
206
210
|
|
207
|
-
|
211
|
+
<hr />
|
208
212
|
|
209
|
-
|
213
|
+
## Usage
|
210
214
|
|
211
|
-
|
215
|
+
1. Install `versionhq` package:
|
216
|
+
```
|
217
|
+
uv pip install versionhq
|
218
|
+
```
|
212
219
|
|
213
|
-
|
214
|
-
- Run a test.
|
220
|
+
2. You can use the `versionhq` module in your Python app.
|
215
221
|
```
|
216
|
-
|
222
|
+
from versionhq.agent.model import Agent
|
223
|
+
agent = Agent(llm="your-llm", ...)
|
217
224
|
```
|
218
|
-
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
219
225
|
|
226
|
+
For more details:
|
220
227
|
|
221
|
-
|
222
|
-
```
|
223
|
-
npm i
|
224
|
-
npm start
|
225
|
-
```
|
226
|
-
The frontend will be available at `http://localhost:3000`.
|
228
|
+
[PyPi package](https://pypi.org/project/versionhq/)
|
227
229
|
|
228
|
-
|
230
|
+
<hr />
|
229
231
|
|
232
|
+
## Contributing
|
230
233
|
|
231
|
-
|
234
|
+
1. Fork the repository
|
232
235
|
|
233
|
-
|
234
|
-
```
|
235
|
-
uv pip install git+https://github.com/versionHQ/multi-agent-system.git#egg=versionhq
|
236
|
-
```
|
236
|
+
2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
|
237
237
|
|
238
|
-
|
239
|
-
```
|
240
|
-
from versionhq.agent.model import Agent
|
241
|
-
agent = Agent(llm="your-llm"...)
|
242
|
-
```
|
238
|
+
3. Create amazing features
|
243
239
|
|
244
|
-
|
240
|
+
4. Test the features using the `tests` directory.
|
245
241
|
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
251
|
-
|
242
|
+
- Add a file to the `tests` directory.
|
243
|
+
- Run a test.
|
244
|
+
```
|
245
|
+
uv run <your file name>
|
246
|
+
```
|
247
|
+
|
248
|
+
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
249
|
+
|
250
|
+
5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
|
251
|
+
6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
|
252
|
+
7. Push to the branch (`git push origin feature/your-amazing-feature`)
|
253
|
+
8. Open a pull request
|
254
|
+
|
255
|
+
|
256
|
+
**Optional**
|
257
|
+
* Flag with `#! REFINEME` for any improvements needed and `#! FIXME` for any errors.
|
258
|
+
|
259
|
+
* Run a React demo app: [React demo app](https://github.com/versionHQ/test-client-app) to check it on the client endpoint.
|
260
|
+
```
|
261
|
+
npm i
|
262
|
+
npm start
|
263
|
+
```
|
264
|
+
The frontend will be available at `http://localhost:3000`.
|
265
|
+
|
266
|
+
* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
|
252
267
|
|
253
|
-
0. Flag with `#! REFINEME` for any improvements and `#! FIXME` for any errors.
|
254
268
|
|
255
269
|
|
256
270
|
### Customizing AI Agents
|
@@ -299,6 +313,8 @@ Pre-commit hooks help maintain code quality by running checks for formatting, li
|
|
299
313
|
git commit --no-verify -m "your-commit-message"
|
300
314
|
```
|
301
315
|
|
316
|
+
<hr />
|
317
|
+
|
302
318
|
## Trouble Shooting
|
303
319
|
|
304
320
|
Common issues and solutions:
|
@@ -309,6 +325,7 @@ Common issues and solutions:
|
|
309
325
|
- Issues related to the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
|
310
326
|
- Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).
|
311
327
|
|
328
|
+
<hr />
|
312
329
|
|
313
330
|
## Frequently Asked Questions (FAQ)
|
314
331
|
**Q. Where can I see if the agent is working?**
|
@@ -1,6 +1,7 @@
|
|
1
1
|
# Overview
|
2
2
|
|
3
|
-
 
|
4
|
+
 
|
4
5
|
|
5
6
|
|
6
7
|
An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
|
@@ -12,10 +13,10 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
12
13
|
|
13
14
|
**Visit:**
|
14
15
|
|
15
|
-
-
|
16
|
-
- Client app
|
17
|
-
-
|
18
|
-
-
|
16
|
+
- [Landing page](https://home.versi0n.io)
|
17
|
+
- [Client app](https://versi0n.io/)
|
18
|
+
- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
|
19
|
+
- [Test client app](https://github.com/versionHQ/test-client-app)
|
19
20
|
|
20
21
|
|
21
22
|
## Mindmap
|
@@ -23,7 +24,7 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
23
24
|
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.
|
24
25
|
|
25
26
|
<p align="center">
|
26
|
-
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="
|
27
|
+
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="400">
|
27
28
|
</p>
|
28
29
|
|
29
30
|
<hr />
|
@@ -37,8 +38,7 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
|
|
37
38
|
- [Project Structure](#project-structure)
|
38
39
|
- [Setup](#setup)
|
39
40
|
- [Usage](#usage)
|
40
|
-
- [
|
41
|
-
- [Contributing & Customizing](#contributing--customizing)
|
41
|
+
- [Contributing](#contributing)
|
42
42
|
- [Customizing AI Agents](#customizing-ai-agents)
|
43
43
|
- [Modifying RAG Functionality](#modifying-rag-functionality)
|
44
44
|
- [Package Management with uv](#package-management-with-uv)
|
@@ -70,6 +70,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
|
|
70
70
|
- Responsible `agents` or `teams` autopilot executing and refining the messaging workflow.
|
71
71
|
|
72
72
|
|
73
|
+
<hr />
|
74
|
+
|
73
75
|
## Technologies Used
|
74
76
|
**Schema, Database, Data Validation**
|
75
77
|
- [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python
|
@@ -120,6 +122,8 @@ src/
|
|
120
122
|
|
121
123
|
```
|
122
124
|
|
125
|
+
<hr />
|
126
|
+
|
123
127
|
## Setup
|
124
128
|
|
125
129
|
1. Install the `uv` package manager:
|
@@ -152,53 +156,63 @@ src/
|
|
152
156
|
COMPOSIO_CLI_KEY=your-composio-cli-key
|
153
157
|
```
|
154
158
|
|
155
|
-
|
159
|
+
<hr />
|
156
160
|
|
157
|
-
|
161
|
+
## Usage
|
158
162
|
|
159
|
-
|
163
|
+
1. Install `versionhq` package:
|
164
|
+
```
|
165
|
+
uv pip install versionhq
|
166
|
+
```
|
160
167
|
|
161
|
-
|
162
|
-
- Run a test.
|
168
|
+
2. You can use the `versionhq` module in your Python app.
|
163
169
|
```
|
164
|
-
|
170
|
+
from versionhq.agent.model import Agent
|
171
|
+
agent = Agent(llm="your-llm", ...)
|
165
172
|
```
|
166
|
-
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
167
173
|
|
174
|
+
For more details:
|
168
175
|
|
169
|
-
|
170
|
-
```
|
171
|
-
npm i
|
172
|
-
npm start
|
173
|
-
```
|
174
|
-
The frontend will be available at `http://localhost:3000`.
|
176
|
+
[PyPi package](https://pypi.org/project/versionhq/)
|
175
177
|
|
176
|
-
|
178
|
+
<hr />
|
177
179
|
|
180
|
+
## Contributing
|
178
181
|
|
179
|
-
|
182
|
+
1. Fork the repository
|
180
183
|
|
181
|
-
|
182
|
-
```
|
183
|
-
uv pip install git+https://github.com/versionHQ/multi-agent-system.git#egg=versionhq
|
184
|
-
```
|
184
|
+
2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
|
185
185
|
|
186
|
-
|
187
|
-
```
|
188
|
-
from versionhq.agent.model import Agent
|
189
|
-
agent = Agent(llm="your-llm"...)
|
190
|
-
```
|
186
|
+
3. Create amazing features
|
191
187
|
|
192
|
-
|
188
|
+
4. Test the features using the `tests` directory.
|
193
189
|
|
194
|
-
|
195
|
-
|
196
|
-
|
197
|
-
|
198
|
-
|
199
|
-
|
190
|
+
- Add a file to the `tests` directory.
|
191
|
+
- Run a test.
|
192
|
+
```
|
193
|
+
uv run <your file name>
|
194
|
+
```
|
195
|
+
|
196
|
+
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
197
|
+
|
198
|
+
5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
|
199
|
+
6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
|
200
|
+
7. Push to the branch (`git push origin feature/your-amazing-feature`)
|
201
|
+
8. Open a pull request
|
202
|
+
|
203
|
+
|
204
|
+
**Optional**
|
205
|
+
* Flag with `#! REFINEME` for any improvements needed and `#! FIXME` for any errors.
|
206
|
+
|
207
|
+
* Run a React demo app: [React demo app](https://github.com/versionHQ/test-client-app) to check it on the client endpoint.
|
208
|
+
```
|
209
|
+
npm i
|
210
|
+
npm start
|
211
|
+
```
|
212
|
+
The frontend will be available at `http://localhost:3000`.
|
213
|
+
|
214
|
+
* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
|
200
215
|
|
201
|
-
0. Flag with `#! REFINEME` for any improvements and `#! FIXME` for any errors.
|
202
216
|
|
203
217
|
|
204
218
|
### Customizing AI Agents
|
@@ -247,6 +261,8 @@ Pre-commit hooks help maintain code quality by running checks for formatting, li
|
|
247
261
|
git commit --no-verify -m "your-commit-message"
|
248
262
|
```
|
249
263
|
|
264
|
+
<hr />
|
265
|
+
|
250
266
|
## Trouble Shooting
|
251
267
|
|
252
268
|
Common issues and solutions:
|
@@ -257,6 +273,7 @@ Common issues and solutions:
|
|
257
273
|
- Issues related to the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
|
258
274
|
- Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).
|
259
275
|
|
276
|
+
<hr />
|
260
277
|
|
261
278
|
## Frequently Asked Questions (FAQ)
|
262
279
|
**Q. Where can I see if the agent is working?**
|
@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
|
|
15
15
|
|
16
16
|
[project]
|
17
17
|
name = "versionhq"
|
18
|
-
version = "1.1.6.
|
18
|
+
version = "1.1.6.4"
|
19
19
|
authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
|
20
20
|
description = "LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows"
|
21
21
|
readme = "README.md"
|
@@ -204,7 +204,7 @@ class Agent(ABC, BaseModel):
|
|
204
204
|
|
205
205
|
if isinstance(self.llm, LLM):
|
206
206
|
self.llm.timeout = self.max_execution_time
|
207
|
-
self.llm.
|
207
|
+
self.llm.max_tokens = self.max_tokens
|
208
208
|
self.llm.context_window_size = (
|
209
209
|
self.llm.get_context_window_size()
|
210
210
|
if self.respect_context_window == True
|
@@ -1,6 +1,6 @@
|
|
1
1
|
Metadata-Version: 2.1
|
2
2
|
Name: versionhq
|
3
|
-
Version: 1.1.6.
|
3
|
+
Version: 1.1.6.4
|
4
4
|
Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
|
5
5
|
Author-email: Kuriko Iwai <kuriko@versi0n.io>
|
6
6
|
License: MIT License
|
@@ -52,7 +52,8 @@ Requires-Dist: wheel>=0.45.1
|
|
52
52
|
|
53
53
|
# Overview
|
54
54
|
|
55
|
-
 
|
56
|
+
 
|
56
57
|
|
57
58
|
|
58
59
|
An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
|
@@ -64,10 +65,10 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
64
65
|
|
65
66
|
**Visit:**
|
66
67
|
|
67
|
-
-
|
68
|
-
- Client app
|
69
|
-
-
|
70
|
-
-
|
68
|
+
- [Landing page](https://home.versi0n.io)
|
69
|
+
- [Client app](https://versi0n.io/)
|
70
|
+
- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
|
71
|
+
- [Test client app](https://github.com/versionHQ/test-client-app)
|
71
72
|
|
72
73
|
|
73
74
|
## Mindmap
|
@@ -75,7 +76,7 @@ Messaging workflows are created at individual level, and will be deployed on thi
|
|
75
76
|
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.
|
76
77
|
|
77
78
|
<p align="center">
|
78
|
-
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="
|
79
|
+
<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1733556715/pj_m_home/urwte15at3h0dr8mdlyo.png" alt="mindmap" width="400">
|
79
80
|
</p>
|
80
81
|
|
81
82
|
<hr />
|
@@ -89,8 +90,7 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
|
|
89
90
|
- [Project Structure](#project-structure)
|
90
91
|
- [Setup](#setup)
|
91
92
|
- [Usage](#usage)
|
92
|
-
- [
|
93
|
-
- [Contributing & Customizing](#contributing--customizing)
|
93
|
+
- [Contributing](#contributing)
|
94
94
|
- [Customizing AI Agents](#customizing-ai-agents)
|
95
95
|
- [Modifying RAG Functionality](#modifying-rag-functionality)
|
96
96
|
- [Package Management with uv](#package-management-with-uv)
|
@@ -122,6 +122,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
|
|
122
122
|
- Responsible `agents` or `teams` autopilot executing and refining the messaging workflow.
|
123
123
|
|
124
124
|
|
125
|
+
<hr />
|
126
|
+
|
125
127
|
## Technologies Used
|
126
128
|
**Schema, Database, Data Validation**
|
127
129
|
- [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python
|
@@ -172,6 +174,8 @@ src/
|
|
172
174
|
|
173
175
|
```
|
174
176
|
|
177
|
+
<hr />
|
178
|
+
|
175
179
|
## Setup
|
176
180
|
|
177
181
|
1. Install the `uv` package manager:
|
@@ -204,53 +208,63 @@ src/
|
|
204
208
|
COMPOSIO_CLI_KEY=your-composio-cli-key
|
205
209
|
```
|
206
210
|
|
207
|
-
|
211
|
+
<hr />
|
208
212
|
|
209
|
-
|
213
|
+
## Usage
|
210
214
|
|
211
|
-
|
215
|
+
1. Install `versionhq` package:
|
216
|
+
```
|
217
|
+
uv pip install versionhq
|
218
|
+
```
|
212
219
|
|
213
|
-
|
214
|
-
- Run a test.
|
220
|
+
2. You can use the `versionhq` module in your Python app.
|
215
221
|
```
|
216
|
-
|
222
|
+
from versionhq.agent.model import Agent
|
223
|
+
agent = Agent(llm="your-llm", ...)
|
217
224
|
```
|
218
|
-
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
219
225
|
|
226
|
+
For more details:
|
220
227
|
|
221
|
-
|
222
|
-
```
|
223
|
-
npm i
|
224
|
-
npm start
|
225
|
-
```
|
226
|
-
The frontend will be available at `http://localhost:3000`.
|
228
|
+
[PyPi package](https://pypi.org/project/versionhq/)
|
227
229
|
|
228
|
-
|
230
|
+
<hr />
|
229
231
|
|
232
|
+
## Contributing
|
230
233
|
|
231
|
-
|
234
|
+
1. Fork the repository
|
232
235
|
|
233
|
-
|
234
|
-
```
|
235
|
-
uv pip install git+https://github.com/versionHQ/multi-agent-system.git#egg=versionhq
|
236
|
-
```
|
236
|
+
2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
|
237
237
|
|
238
|
-
|
239
|
-
```
|
240
|
-
from versionhq.agent.model import Agent
|
241
|
-
agent = Agent(llm="your-llm"...)
|
242
|
-
```
|
238
|
+
3. Create amazing features
|
243
239
|
|
244
|
-
|
240
|
+
4. Test the features using the `tests` directory.
|
245
241
|
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
251
|
-
|
242
|
+
- Add a file to the `tests` directory.
|
243
|
+
- Run a test.
|
244
|
+
```
|
245
|
+
uv run <your file name>
|
246
|
+
```
|
247
|
+
|
248
|
+
* All the `.py` files' names in the `tests` have to be ended with `_test.py`.
|
249
|
+
|
250
|
+
5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
|
251
|
+
6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
|
252
|
+
7. Push to the branch (`git push origin feature/your-amazing-feature`)
|
253
|
+
8. Open a pull request
|
254
|
+
|
255
|
+
|
256
|
+
**Optional**
|
257
|
+
* Flag with `#! REFINEME` for any improvements needed and `#! FIXME` for any errors.
|
258
|
+
|
259
|
+
* Run a React demo app: [React demo app](https://github.com/versionHQ/test-client-app) to check it on the client endpoint.
|
260
|
+
```
|
261
|
+
npm i
|
262
|
+
npm start
|
263
|
+
```
|
264
|
+
The frontend will be available at `http://localhost:3000`.
|
265
|
+
|
266
|
+
* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
|
252
267
|
|
253
|
-
0. Flag with `#! REFINEME` for any improvements and `#! FIXME` for any errors.
|
254
268
|
|
255
269
|
|
256
270
|
### Customizing AI Agents
|
@@ -299,6 +313,8 @@ Pre-commit hooks help maintain code quality by running checks for formatting, li
|
|
299
313
|
git commit --no-verify -m "your-commit-message"
|
300
314
|
```
|
301
315
|
|
316
|
+
<hr />
|
317
|
+
|
302
318
|
## Trouble Shooting
|
303
319
|
|
304
320
|
Common issues and solutions:
|
@@ -309,6 +325,7 @@ Common issues and solutions:
|
|
309
325
|
- Issues related to the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
|
310
326
|
- Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).
|
311
327
|
|
328
|
+
<hr />
|
312
329
|
|
313
330
|
## Frequently Asked Questions (FAQ)
|
314
331
|
**Q. Where can I see if the agent is working?**
|
@@ -16,7 +16,7 @@ def sync_test():
|
|
16
16
|
backstory="My amazing backstory",
|
17
17
|
verbose=True,
|
18
18
|
llm=MODEL_NAME,
|
19
|
-
|
19
|
+
max_tokens=3000,
|
20
20
|
)
|
21
21
|
task = Task(
|
22
22
|
description="Analyze the client's business model, target audience, and customer information and define the optimal cohort timeframe based on customer lifecycle and product usage patterns.",
|
@@ -20,7 +20,7 @@ def kickoff_test() -> Union[TeamOutput | Dict[str, Any]]:
|
|
20
20
|
backstory="My amazing backstory",
|
21
21
|
verbose=True,
|
22
22
|
llm=MODEL_NAME,
|
23
|
-
|
23
|
+
max_tokens=3000,
|
24
24
|
)
|
25
25
|
|
26
26
|
agent_b1 = Agent(
|
@@ -29,7 +29,7 @@ def kickoff_test() -> Union[TeamOutput | Dict[str, Any]]:
|
|
29
29
|
backstory="My amazing backstory",
|
30
30
|
verbose=True,
|
31
31
|
llm=MODEL_NAME,
|
32
|
-
|
32
|
+
max_tokens=3000,
|
33
33
|
)
|
34
34
|
|
35
35
|
task_1 = Task(
|
versionhq-1.1.6.3/Procfile
DELETED
@@ -1 +0,0 @@
|
|
1
|
-
web: gunicorn --bind :$PORT app:app
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|
File without changes
|