versionhq 1.1.10.8__tar.gz → 1.1.11.0__tar.gz

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.github/workflows/publish.yml

@@ -21,7 +21,7 @@ jobs:
 
       - name: Build release distributions
         run: |
-          uv venv --python 3.13.1
+          uv venv --python 3.12.8
           source .venv/bin/activate
           uv pip install --upgrade pip twine
           uv pip install -r requirements.txt

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.github/workflows/publish_testpypi.yml

@@ -22,7 +22,7 @@ jobs:
 
       - name: Build release distributions
         run: |
-          uv venv --python 3.13.1
+          uv venv --python 3.12.8
           source .venv/bin/activate
           uv pip install --upgrade pip twine
           uv pip install -r requirements.txt

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.github/workflows/run_tests.yml

@@ -17,6 +17,7 @@ env:
   GEMINI_API_BASE: ${{ secrets.GEMINI_API_BASE }}
   ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
   ANTHROPIC_API_BASE: ${{ secrets.ANTHROPIC_API_BASE }}
+  MEM0_API_KEY: ${{ secrets.MEM0_API_KEY }}
 
 jobs:
   run_test:
@@ -34,7 +35,7 @@ jobs:
 
       - name: Set up the project
         run: |
-          uv venv --python 3.13.1
+          uv venv --python 3.12.8
           source .venv/bin/activate
           uv pip install --upgrade pip pytest
           uv pip install -r requirements.txt

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.github/workflows/security_check.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.13.1"
+          python-version: "3.12.8"
 
       - name: Install dependencies
         run: uv pip install bandit

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.gitignore

@@ -1,8 +1,9 @@
 deploy.py
 destinations.py
 
-knowledge/
-memory/
+entity_memory.py
+
+train.py
 
 memo.txt
 

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/.pre-commit-config.yaml

@@ -6,7 +6,7 @@ repos:
     -   id: end-of-file-fixer
     -   id: trailing-whitespace
     -   id: check-added-large-files
-        args: ['--maxkb=100']
+        args: ['--maxkb=200']
     -   id: check-json
     -   id: check-merge-conflict
     -   id: check-toml

versionhq-1.1.11.0/.python-version

@@ -0,0 +1 @@
+3.12.8

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.10.8
+Version: 1.1.11.0
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -56,24 +56,29 @@ Requires-Dist: appdirs>=1.4.4
 Requires-Dist: langchain>=0.3.14
 Requires-Dist: langchain-openai>=0.2.14
 Requires-Dist: composio-langchain>=0.6.12
+Requires-Dist: chromadb>=0.6.3
+Requires-Dist: docling>=2.16.0
+Requires-Dist: json-repair>=0.35.0
+Requires-Dist: wheel>=0.45.1
+Requires-Dist: pdfplumber>=0.11.5
+Requires-Dist: mem0ai>=0.1.48
 
 # Overview
 
 ![MIT license](https://img.shields.io/badge/License-MIT-green)
 [![Publisher](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml/badge.svg)](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml)
 ![PyPI](https://img.shields.io/badge/PyPI->=v1.1.10-blue)
-![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
+![python ver](https://img.shields.io/badge/Python->=3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
-LLM orchestration frameworks to deploy multi-agent systems focusing on complex outbound tasks.
+LLM orchestration frameworks to deploy multi-agent systems with task-based formation.
 
 **Visit:**
 
 - [PyPI](https://pypi.org/project/versionhq/)
 - [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)
+- [Use case](https://versi0n.io/) / [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.
 
 
@@ -133,7 +138,7 @@ You can specify which formation you want them to generate, or let the agent deci
    pip install versionhq
    ```
 
-(Python >= 3.13)
+(Python >= 3.12)
 
 
 ### Case 1. Solo Agent:
@@ -157,7 +162,7 @@ You can specify which formation you want them to generate, or let the agent deci
 
    task = Task(
       description="Amazing task",
-      pydantic_custom_output=CustomOutput,
+      pydantic_output=CustomOutput,
       callback=dummy_func,
       callback_kwargs=dict(message="Hi! Here is the result: ")
    )
@@ -166,14 +171,17 @@ You can specify which formation you want them to generate, or let the agent deci
    print(res)
    ```
 
-This will return `TaskOutput` that stores a response in string, JSON dict, and Pydantic model: `CustomOutput` formats with a callback result.
+This will return `TaskOutput` instance that stores a response in plane text, JSON serializable dict, and Pydantic model: `CustomOutput` formats with a callback result, tool output (if given), and evaluation results (if given).
 
    ```
    res == TaskOutput(
-      raw="{\\"test1\\": \\"random str\\", \\"test2\\": [\\"item1\\", \\"item2\\"]}",
-      json_dict={"test1": "random str", "test2": ["item1", "item2"]},
-      pydantic=CustomOutput(test1="random str", test2=["item 1", "item 2"]),
-      callback_output="Hi! Here is the result: random str, item 1, item 2",
+      task_id=UUID('<TASK UUID>')
+      raw='{\"test1\":\"random str\", \"test2\":[\"str item 1\", \"str item 2\", \"str item 3\"]}',
+      json_dict={'test1': 'random str', 'test2': ['str item 1', 'str item 2', 'str item 3']},
+      pydantic=<class '__main__.CustomOutput'>
+      tool_output=None,
+      callback_output='Hi! Here is the result: random str, str item 1, str item 2, str item 3',
+      evaluation=None
    )
    ```
 
@@ -215,15 +223,18 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 <hr />
 
 ## Technologies Used
-**Schema, Database, Data Validation**
-   - [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python
-   - [Pydantic_core](https://pypi.org/project/pydantic-core/): Core func packages for Pydantic
-   - [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data
-   - [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine
+**Schema, Data Validation**
+   - [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python.
+   - [Pydantic_core](https://pypi.org/project/pydantic-core/): Core func packages for Pydantic.
    - [Upstage](https://console.upstage.ai/docs/getting-started/overview): Document processer for ML tasks. (Use `Document Parser API` to extract data from documents)
+   - [Docling](https://ds4sd.github.io/docling/): Document parsing
+
+**Storage**
+   - [mem0ai](https://docs.mem0.ai/quickstart#install-package): Agents' memory storage and management.
+   - [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data.
+   - [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine.
 
 **LLM-curation**
-   - OpenAI GPT-4: Advanced language model for analysis and recommendations
    - [LiteLLM](https://docs.litellm.ai/docs/providers): Curation platform to access LLMs
 
 **Tools**
@@ -241,27 +252,29 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 
 ```
 .
+.github
+└── workflows/                # Github actions
+│
 src/
-└── versionHQ/                  # Orchestration frameworks on Pydantic
-│      ├── agent/
-│      └── llm/
-│      └── task/
-│      └── team/
-│      └── tool/
-│      └── clients/            # Classes to store the client related information
-│      └── cli/                # CLI commands
-│      └── ...
-│      │
-│      ├── db/                 # Database files
-│      ├── chroma.sqlite3
-│      └── ...
+└── versionhq/                # Orchestration frameworks
+│     ├── agent/              # Components
+│     └── llm/
+│     └── task/
+│     └── team/
+│     └── tool/
+│     └── cli/
+│     └── ...
+│     │
+│     ├── db/                 # Storage
+│     ├── chroma.sqlite3
+│     └── ...
+│
+└──tests/                     # Pytest
+│     └── agent/
+│     └── llm/
+│     └── ...
 │
-└──tests/
-      └── cli/
-      └── team/
-      └── ...
-      │
-      └── uploads/    # Uploaded files for the project
+└── uploads/                  # Local repo to store the uploaded files
 
 ```
 
@@ -283,9 +296,9 @@ src/
 
 * In case of AssertionError/module mismatch, run Python version control using `.pyenv`
    ```
-   pyenv install 3.13.1
-   pyenv global 3.13.1  (optional: `pyenv global system` to get back to the system default ver.)
-   uv python pin 3.13.1
+   pyenv install 3.12.8
+   pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
+   uv python pin 3.12.8
    ```
 
 3. Set up environment variables:
@@ -394,6 +407,7 @@ Common issues and solutions:
 - API key errors: Ensure all API keys in the `.env` file are correct and up to date. Make sure to add `load_dotenv()` on the top of the python file to apply the latest environment values.
 - Database connection issues: Check if the Chroma DB is properly initialized and accessible.
 - Memory errors: If processing large contracts, you may need to increase the available memory for the Python process.
+- Issues related to the Python version: Docling/Pytorch is not ready for Python 3.13 as of Jan 2025. Use Python 3.12.x as default by running `uv venv --python 3.12.8` and `uv python pin 3.12.8`.
 - Issues related to dependencies: `rm -rf uv.lock`, `uv cache clean`, `uv venv`, and run `uv pip install -r requirements.txt -v`.
 - Issues related to the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
 - Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/README.md

@@ -3,18 +3,17 @@
 ![MIT license](https://img.shields.io/badge/License-MIT-green)
 [![Publisher](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml/badge.svg)](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml)
 ![PyPI](https://img.shields.io/badge/PyPI->=v1.1.10-blue)
-![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
+![python ver](https://img.shields.io/badge/Python->=3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
-LLM orchestration frameworks to deploy multi-agent systems focusing on complex outbound tasks.
+LLM orchestration frameworks to deploy multi-agent systems with task-based formation.
 
 **Visit:**
 
 - [PyPI](https://pypi.org/project/versionhq/)
 - [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)
+- [Use case](https://versi0n.io/) / [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.
 
 
@@ -74,7 +73,7 @@ You can specify which formation you want them to generate, or let the agent deci
    pip install versionhq
    ```
 
-(Python >= 3.13)
+(Python >= 3.12)
 
 
 ### Case 1. Solo Agent:
@@ -98,7 +97,7 @@ You can specify which formation you want them to generate, or let the agent deci
 
    task = Task(
       description="Amazing task",
-      pydantic_custom_output=CustomOutput,
+      pydantic_output=CustomOutput,
       callback=dummy_func,
       callback_kwargs=dict(message="Hi! Here is the result: ")
    )
@@ -107,14 +106,17 @@ You can specify which formation you want them to generate, or let the agent deci
    print(res)
    ```
 
-This will return `TaskOutput` that stores a response in string, JSON dict, and Pydantic model: `CustomOutput` formats with a callback result.
+This will return `TaskOutput` instance that stores a response in plane text, JSON serializable dict, and Pydantic model: `CustomOutput` formats with a callback result, tool output (if given), and evaluation results (if given).
 
    ```
    res == TaskOutput(
-      raw="{\\"test1\\": \\"random str\\", \\"test2\\": [\\"item1\\", \\"item2\\"]}",
-      json_dict={"test1": "random str", "test2": ["item1", "item2"]},
-      pydantic=CustomOutput(test1="random str", test2=["item 1", "item 2"]),
-      callback_output="Hi! Here is the result: random str, item 1, item 2",
+      task_id=UUID('<TASK UUID>')
+      raw='{\"test1\":\"random str\", \"test2\":[\"str item 1\", \"str item 2\", \"str item 3\"]}',
+      json_dict={'test1': 'random str', 'test2': ['str item 1', 'str item 2', 'str item 3']},
+      pydantic=<class '__main__.CustomOutput'>
+      tool_output=None,
+      callback_output='Hi! Here is the result: random str, str item 1, str item 2, str item 3',
+      evaluation=None
    )
    ```
 
@@ -156,15 +158,18 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 <hr />
 
 ## Technologies Used
-**Schema, Database, Data Validation**
-   - [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python
-   - [Pydantic_core](https://pypi.org/project/pydantic-core/): Core func packages for Pydantic
-   - [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data
-   - [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine
+**Schema, Data Validation**
+   - [Pydantic](https://docs.pydantic.dev/latest/): Data validation and serialization library for Python.
+   - [Pydantic_core](https://pypi.org/project/pydantic-core/): Core func packages for Pydantic.
    - [Upstage](https://console.upstage.ai/docs/getting-started/overview): Document processer for ML tasks. (Use `Document Parser API` to extract data from documents)
+   - [Docling](https://ds4sd.github.io/docling/): Document parsing
+
+**Storage**
+   - [mem0ai](https://docs.mem0.ai/quickstart#install-package): Agents' memory storage and management.
+   - [Chroma DB](https://docs.trychroma.com/): Vector database for storing and querying usage data.
+   - [SQLite](https://www.sqlite.org/docs.html): C-language library to implements a small SQL database engine.
 
 **LLM-curation**
-   - OpenAI GPT-4: Advanced language model for analysis and recommendations
    - [LiteLLM](https://docs.litellm.ai/docs/providers): Curation platform to access LLMs
 
 **Tools**
@@ -182,27 +187,29 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
 
 ```
 .
+.github
+└── workflows/                # Github actions
+│
 src/
-└── versionHQ/                  # Orchestration frameworks on Pydantic
-│      ├── agent/
-│      └── llm/
-│      └── task/
-│      └── team/
-│      └── tool/
-│      └── clients/            # Classes to store the client related information
-│      └── cli/                # CLI commands
-│      └── ...
-│      │
-│      ├── db/                 # Database files
-│      ├── chroma.sqlite3
-│      └── ...
+└── versionhq/                # Orchestration frameworks
+│     ├── agent/              # Components
+│     └── llm/
+│     └── task/
+│     └── team/
+│     └── tool/
+│     └── cli/
+│     └── ...
+│     │
+│     ├── db/                 # Storage
+│     ├── chroma.sqlite3
+│     └── ...
+│
+└──tests/                     # Pytest
+│     └── agent/
+│     └── llm/
+│     └── ...
 │
-└──tests/
-      └── cli/
-      └── team/
-      └── ...
-      │
-      └── uploads/    # Uploaded files for the project
+└── uploads/                  # Local repo to store the uploaded files
 
 ```
 
@@ -224,9 +231,9 @@ src/
 
 * In case of AssertionError/module mismatch, run Python version control using `.pyenv`
    ```
-   pyenv install 3.13.1
-   pyenv global 3.13.1  (optional: `pyenv global system` to get back to the system default ver.)
-   uv python pin 3.13.1
+   pyenv install 3.12.8
+   pyenv global 3.12.8  (optional: `pyenv global system` to get back to the system default ver.)
+   uv python pin 3.12.8
    ```
 
 3. Set up environment variables:
@@ -335,6 +342,7 @@ Common issues and solutions:
 - API key errors: Ensure all API keys in the `.env` file are correct and up to date. Make sure to add `load_dotenv()` on the top of the python file to apply the latest environment values.
 - Database connection issues: Check if the Chroma DB is properly initialized and accessible.
 - Memory errors: If processing large contracts, you may need to increase the available memory for the Python process.
+- Issues related to the Python version: Docling/Pytorch is not ready for Python 3.13 as of Jan 2025. Use Python 3.12.x as default by running `uv venv --python 3.12.8` and `uv python pin 3.12.8`.
 - Issues related to dependencies: `rm -rf uv.lock`, `uv cache clean`, `uv venv`, and run `uv pip install -r requirements.txt -v`.
 - Issues related to the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
 - Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).

{versionhq-1.1.10.8 → versionhq-1.1.11.0}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.10.8"
+version = "1.1.11.0"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows"
 readme = "README.md"
@@ -39,7 +39,13 @@ dependencies = [
   "appdirs>=1.4.4",
   "langchain>=0.3.14",
   "langchain-openai>=0.2.14",
-  "composio-langchain>=0.6.12"
+  "composio-langchain>=0.6.12",
+  "chromadb>=0.6.3",
+  "docling>=2.16.0",
+  "json-repair>=0.35.0",
+  "wheel>=0.45.1",
+  "pdfplumber>=0.11.5",
+  "mem0ai>=0.1.48",
 ]
 classifiers = [
   "Programming Language :: Python",
@@ -47,7 +53,7 @@ classifiers = [
   "Operating System :: OS Independent",
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
-  "Topic :: Software Development :: Build Tools",
+  "Topic :: Software Development :: Build Tools"
 ]
 
 [project.urls]