versionhq 1.1.10.7__tar.gz → 1.1.10.9__tar.gz

{versionhq-1.1.10.7 → versionhq-1.1.10.9}/.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.7 → versionhq-1.1.10.9}/.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.7 → versionhq-1.1.10.9}/.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.7 → versionhq-1.1.10.9}/.gitignore

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

{versionhq-1.1.10.7 → versionhq-1.1.10.9}/.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.10.9/.python-version

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

{versionhq-1.1.10.7 → versionhq-1.1.10.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.10.7
+Version: 1.1.10.9
 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.
 
 
@@ -86,9 +91,9 @@ LLM orchestration frameworks to deploy multi-agent systems focusing on complex o
 - [Key Features](#key-features)
   - [Agent formation](#agent-formation)
 - [Quick Start](#quick-start)
-  - [Case 1. Single agent network:](#case-1-single-agent-network)
+  - [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. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
+  - [Case 2. Supervising:](#case-2-supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -133,10 +138,10 @@ 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. Single agent network:
+### Case 1. Solo Agent:
 
 #### Return a structured output with a summary in string.
 
@@ -177,7 +182,7 @@ This will return `TaskOutput` that stores a response in string, JSON dict, and P
    )
    ```
 
-### Case 2. Form a team to handle multiple tasks:
+### Case 2. Supervising:
 
    ```
    from versionhq.agent.model import Agent
@@ -212,19 +217,21 @@ 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
-**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**
@@ -242,27 +249,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
 
 ```
 
@@ -284,9 +293,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:

{versionhq-1.1.10.7 → versionhq-1.1.10.9}/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.
 
 
@@ -27,9 +26,9 @@ LLM orchestration frameworks to deploy multi-agent systems focusing on complex o
 - [Key Features](#key-features)
   - [Agent formation](#agent-formation)
 - [Quick Start](#quick-start)
-  - [Case 1. Single agent network:](#case-1-single-agent-network)
+  - [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. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
+  - [Case 2. Supervising:](#case-2-supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -74,10 +73,10 @@ 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. Single agent network:
+### Case 1. Solo Agent:
 
 #### Return a structured output with a summary in string.
 
@@ -118,7 +117,7 @@ This will return `TaskOutput` that stores a response in string, JSON dict, and P
    )
    ```
 
-### Case 2. Form a team to handle multiple tasks:
+### Case 2. Supervising:
 
    ```
    from versionhq.agent.model import Agent
@@ -153,19 +152,21 @@ 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
-**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**
@@ -183,27 +184,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
 
 ```
 
@@ -225,9 +228,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:

{versionhq-1.1.10.7 → versionhq-1.1.10.9}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.10.7"
+version = "1.1.10.9"
 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]