lionagi 0.12.2__tar.gz → 0.12.4__tar.gz

lionagi-0.12.4/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [lion-agi]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

lionagi-0.12.4/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: Continuous Integration
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install uv
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+    
+    - name: Load cached dependencies
+      id: cached-uv-dependencies
+      uses: actions/cache@v4
+      with:
+        path: .venv
+        key: venv-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml') }}
+    
+    - name: Install dependencies
+      if: steps.cached-uv-dependencies.outputs.cache-hit != 'true'
+      run: |
+        uv venv
+        uv sync --extra all
+    
+    - name: Run tests
+      run: |
+        source .venv/bin/activate
+        uv run pytest --asyncio-mode=auto --maxfail=1 --disable-warnings tests/
+    
+    - name: Check code style and compatibility
+      run: |
+        source .venv/bin/activate
+        uv run black --check .
+        uv run isort --check-only .
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+    
+    - name: Install uv
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+    
+    - name: Build package
+      run: uv build

lionagi-0.12.4/.github/workflows/codeql.yml

@@ -0,0 +1,40 @@
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+  schedule:
+    - cron: '0 0 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+
+# filepath: .github/workflows/codeql-analysis.yml

{lionagi-0.12.2 → lionagi-0.12.4}/.github/workflows/docs.yml

@@ -2,10 +2,7 @@ name: Build and Deploy Docs
 
 on:
   push:
-    branches: ["main"]
-
-permissions:
-  contents: write
+    branches: [ "main" ]
 
 jobs:
   build-deploy:

lionagi-0.12.4/.github/workflows/release.yml

@@ -0,0 +1,65 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install uv
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+    
+    - name: Install dependencies
+      run: |
+        uv venv
+        uv sync --extra all
+    
+    - name: Run tests
+      run: |
+        source .venv/bin/activate
+        uv run pytest --asyncio-mode=auto --maxfail=1 --disable-warnings tests/
+
+  deploy:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.12"
+    
+    - name: Install uv
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+    
+    - name: Install dependencies
+      run: |
+        uv venv
+        uv pip install twine
+    
+    - name: Build package
+      run: uv build
+    
+    - name: Publish package to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_KEY }}
+      run: uv run twine upload dist/*

{lionagi-0.12.2 → lionagi-0.12.4}/.gitignore

@@ -3,6 +3,9 @@ __pycache__/
 *.py[cod]
 *$py.class
 
+# Development notes
+CLAUDE.md
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -170,4 +173,4 @@ cython_debug/
 .roomodes
 .khive/
 .roo/
-data/logs/
+*logs/

lionagi-0.12.4/.python-version

@@ -0,0 +1 @@
+3.10

lionagi-0.12.4/CODE_OF_CONDUCT.md

@@ -0,0 +1,75 @@
+# LionAGI Code of Conduct
+
+## A. Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as members, contributors, and leaders of the LionAGI community pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of background, identity, and personal characteristics.
+
+We commit to act and interact in ways that contribute to an inclusive, diverse, and friendly community.
+
+## B. Our Standards
+
+Examples of behavior that contribute to a positive environment include:
+
+* Demonstrating empathy and kindness toward other people.
+* Being respectful of differing opinions, viewpoints, and experiences.
+* Giving and gracefully accepting constructive feedback.
+* Accepting responsibility for our actions, apologizing to those affected by our mistakes, and learning from the experience.
+* Focusing on what is best for the community as a whole.
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of any kind.
+* Trolling, insulting or derogatory comments, and personal or political attacks.
+* Public or private harassment.
+* Publishing others' private information, such as a physical or email address, without explicit permission.
+* Other conduct which could reasonably be considered inappropriate in a professional setting.
+
+## C. Enforcement Responsibilities
+
+Our community leaders are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct.
+
+## D. Scope
+
+This Code of Conduct applies within all community spaces, including GitHub, Discord, and various social media platforms, and also applies when an individual is officially representing the community.
+
+## E. Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team via our Discord server. All complaints will be reviewed and investigated in a manner that ensures fairness and respect for all parties.
+
+Community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## F. Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action deemed in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or behavior deemed unprofessional.
+
+**Consequence**: A private written warning from community leaders, with an explanation of why the behavior was inappropriate.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. This includes a temporary ban from community interaction if the behavior persists.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards.
+
+**Consequence**: A temporary ban from any sort of interaction within the community.
+
+### 4. Permanent Ban
+
+**Community Impact**: Sustained inappropriate behavior, harassment, or aggression toward individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## G. Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.0, available at [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html).
+
+For answers to common questions about this code of conduct, see the [FAQ](https://www.contributor-covenant.org/faq).

{lionagi-0.12.2 → lionagi-0.12.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lionagi
-Version: 0.12.2
+Version: 0.12.4
 Summary: An Intelligence Operating System.
 Author-email: HaiyangLi <quantocean.li@gmail.com>, Liangbingyan Luo <llby_luo@outlook.com>
 License:            Apache License
@@ -219,19 +219,37 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
-Requires-Dist: jinja2>=3.0.0
-Requires-Dist: khive>=0.2.7
+Requires-Dist: aiocache>=0.12.0
+Requires-Dist: aiohttp>=3.12.0
+Requires-Dist: backoff>=2.2.1
+Requires-Dist: jinja2>=3.1.0
 Requires-Dist: pandas>=2.0.0
+Requires-Dist: pillow>=11.0.0
+Requires-Dist: pydantic-settings>=2.8.0
+Requires-Dist: pydantic>2.0.0
+Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: tiktoken>=0.8.0
+Requires-Dist: toml>=0.9.0
 Provides-Extra: all
-Requires-Dist: khive[ollama,reader]; extra == 'all'
-Requires-Dist: litellm; extra == 'all'
-Provides-Extra: llms
-Requires-Dist: litellm; extra == 'llms'
+Requires-Dist: docling>=2.15.1; extra == 'all'
+Requires-Dist: ollama>=0.5.0; extra == 'all'
+Provides-Extra: docs
+Requires-Dist: furo>=2024.8.6; extra == 'docs'
+Requires-Dist: sphinx-autobuild>=2024.10.3; extra == 'docs'
+Requires-Dist: sphinx>=8.1.3; extra == 'docs'
+Provides-Extra: lint
+Requires-Dist: black[jupyter]>=24.10.0; extra == 'lint'
+Requires-Dist: isort>=5.13.2; extra == 'lint'
+Requires-Dist: pre-commit>=4.0.1; extra == 'lint'
 Provides-Extra: ollama
-Requires-Dist: khive[ollama]; extra == 'ollama'
+Requires-Dist: ollama>=0.5.0; extra == 'ollama'
+Provides-Extra: reader
+Requires-Dist: docling>=2.15.1; extra == 'reader'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=1.0.0; extra == 'test'
+Requires-Dist: pytest>=8.3.4; extra == 'test'
 Provides-Extra: tools
-Requires-Dist: khive[reader]; extra == 'tools'
+Requires-Dist: docling>=2.15.1; extra == 'tools'
 Description-Content-Type: text/markdown
 
 ![PyPI - Version](https://img.shields.io/pypi/v/lionagi?labelColor=233476aa&color=231fc935)
@@ -239,9 +257,8 @@ Description-Content-Type: text/markdown
 ![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
 
 [Documentation](https://lion-agi.github.io/lionagi/) |
-[Discord](https://discord.gg/aqSJ2v46vu) |
+[Discord](https://discord.gg/JDj9ENhUE8) |
 [PyPI](https://pypi.org/project/lionagi/) |
-[Roadmap](https://trello.com/b/3seomsrI/lionagi)
 
 # LION - Language InterOperable Network
 
@@ -267,9 +284,6 @@ integrations, and custom validations in a single coherent pipeline.
 pip install lionagi
 ```
 
-Dependencies: •	aiocahce •	aiohttp •	jinja2 •	pandas •	pillow •	pydantic
-•	python-dotenv •	tiktoken
-
 ## Quick Start
 
 ```python
@@ -321,6 +335,10 @@ With fiery claws, dragons hide their laughter flaws!
 LionAGI supports advanced multi-step reasoning with ReAct. Tools let the LLM
 invoke external actions:
 
+```
+pip install "lionagi[reader]"
+```
+
 ```python
 from lionagi.tools.types import ReaderTool
 
@@ -375,8 +393,7 @@ Seamlessly route to different models in the same workflow.
 ### optional dependencies
 
 ```
-pip install "lionagi[tools]"
-pip install "lionagi[llms]"
+pip install "lionagi[reader]"
 pip install "lionagi[ollama]"
 ```
 

{lionagi-0.12.2 → lionagi-0.12.4}/README.md

@@ -3,9 +3,8 @@
 ![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
 
 [Documentation](https://lion-agi.github.io/lionagi/) |
-[Discord](https://discord.gg/aqSJ2v46vu) |
+[Discord](https://discord.gg/JDj9ENhUE8) |
 [PyPI](https://pypi.org/project/lionagi/) |
-[Roadmap](https://trello.com/b/3seomsrI/lionagi)
 
 # LION - Language InterOperable Network
 
@@ -31,9 +30,6 @@ integrations, and custom validations in a single coherent pipeline.
 pip install lionagi
 ```
 
-Dependencies: •	aiocahce •	aiohttp •	jinja2 •	pandas •	pillow •	pydantic
-•	python-dotenv •	tiktoken
-
 ## Quick Start
 
 ```python
@@ -85,6 +81,10 @@ With fiery claws, dragons hide their laughter flaws!
 LionAGI supports advanced multi-step reasoning with ReAct. Tools let the LLM
 invoke external actions:
 
+```
+pip install "lionagi[reader]"
+```
+
 ```python
 from lionagi.tools.types import ReaderTool
 
@@ -139,8 +139,7 @@ Seamlessly route to different models in the same workflow.
 ### optional dependencies
 
 ```
-pip install "lionagi[tools]"
-pip install "lionagi[llms]"
+pip install "lionagi[reader]"
 pip install "lionagi[ollama]"
 ```
 

lionagi-0.12.4/lionagi/config.py

@@ -0,0 +1,123 @@
+# Copyright (c) 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from typing import Any, ClassVar
+
+from pydantic import BaseModel, Field, SecretStr
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class CacheConfig(BaseModel):
+    """Configuration for aiocache."""
+
+    ttl: int = 300
+    key: str | None = None
+    namespace: str | None = None
+    key_builder: Any = None
+    skip_cache_func: Any = lambda _: False
+    serializer: dict[str, Any] | None = None
+    plugins: Any = None
+    alias: str | None = None
+    noself: Any = lambda _: False
+
+    def as_kwargs(self) -> dict[str, Any]:
+        """Convert config to kwargs dict for @cached decorator.
+
+        Removes unserialisable callables that aiocache can't pickle.
+        """
+        raw = self.model_dump(exclude_none=True)
+        # Remove all unserialisable callables
+        unserialisable_keys = (
+            "key_builder",
+            "skip_cache_func",
+            "noself",
+            "serializer",
+            "plugins",
+        )
+        for key in unserialisable_keys:
+            raw.pop(key, None)
+        return raw
+
+
+class AppSettings(BaseSettings, frozen=True):
+    """Application settings with environment variable support."""
+
+    model_config = SettingsConfigDict(
+        env_file=(".env", ".env.local", ".secrets.env"),
+        env_file_encoding="utf-8",
+        case_sensitive=False,
+        extra="ignore",
+    )
+
+    aiocache_config: CacheConfig = Field(
+        default_factory=CacheConfig, description="Cache settings for aiocache"
+    )
+
+    # secrets
+    OPENAI_API_KEY: SecretStr | None = None
+    OPENROUTER_API_KEY: SecretStr | None = None
+    OLLAMA_API_KEY: SecretStr | None = None
+    EXA_API_KEY: SecretStr | None = None
+    PERPLEXITY_API_KEY: SecretStr | None = None
+    GROQ_API_KEY: SecretStr | None = None
+    ANTHROPIC_API_KEY: SecretStr | None = None
+
+    # defaults models
+    LIONAGI_EMBEDDING_PROVIDER: str = "openai"
+    LIONAGI_EMBEDDING_MODEL: str = "text-embedding-3-small"
+
+    LIONAGI_CHAT_PROVIDER: str = "openai"
+    LIONAGI_CHAT_MODEL: str = "gpt-4o"
+
+    # default storage
+    LIONAGI_AUTO_STORE_EVENT: bool = False
+    LIONAGI_STORAGE_PROVIDER: str = "async_qdrant"
+
+    LIONAGI_AUTO_EMBED_LOG: bool = False
+
+    # specific storage
+    LIONAGI_QDRANT_URL: str = "http://localhost:6333"
+    LIONAGI_DEFAULT_QDRANT_COLLECTION: str = "event_logs"
+
+    # Class variable to store the singleton instance
+    _instance: ClassVar[Any] = None
+
+    def get_secret(self, key_name: str) -> str:
+        """
+        Get the secret value for a given key name.
+
+        Args:
+            key_name: The name of the secret key (e.g., "OPENAI_API_KEY")
+
+        Returns:
+            The secret value as a string
+
+        Raises:
+            AttributeError: If the key doesn't exist
+            ValueError: If the key exists but is None
+        """
+        if not hasattr(self, key_name):
+            if "ollama" in key_name.lower():
+                return "ollama"
+            raise AttributeError(
+                f"Secret key '{key_name}' not found in settings"
+            )
+
+        secret = getattr(self, key_name)
+        if secret is None:
+            # Special case for Ollama - return "ollama" even if key exists but is None
+            if "ollama" in key_name.lower():
+                return "ollama"
+            raise ValueError(f"Secret key '{key_name}' is not set")
+
+        if isinstance(secret, SecretStr):
+            return secret.get_secret_value()
+
+        return str(secret)
+
+
+# Create a singleton instance
+settings = AppSettings()
+# Store the instance in the class variable for singleton pattern
+AppSettings._instance = settings

{lionagi-0.12.2 → lionagi-0.12.4}/lionagi/fields/file.py

@@ -71,7 +71,7 @@ class File(HashableModel):
         header: str | None = None,
         footer: str | None = None,
     ) -> Path:
-        from lionagi.libs.file.create_path import create_path
+        from lionagi.utils import create_path
 
         fp = create_path(
             directory=directory,

{lionagi-0.12.2 → lionagi-0.12.4}/lionagi/fields/reason.py

@@ -4,8 +4,8 @@
 
 from pydantic import Field, field_validator
 
-from lionagi.libs.parse.to_num import to_num
 from lionagi.models import FieldModel, HashableModel
+from lionagi.utils import to_num
 
 __all__ = ("Reason",)
 

{lionagi-0.12.2 → lionagi-0.12.4}/lionagi/libs/file/concat.py

@@ -1,12 +1,7 @@
-# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
-#
-# SPDX-License-Identifier: Apache-2.0
-
 from pathlib import Path
 from typing import Any
 
-from lionagi.libs.file.create_path import create_path
-from lionagi.utils import lcall
+from lionagi.utils import create_path, lcall
 
 from .process import dir_to_files
 

{lionagi-0.12.2 → lionagi-0.12.4}/lionagi/libs/file/concat_files.py

@@ -1,10 +1,6 @@
-# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
-#
-# SPDX-License-Identifier: Apache-2.0
-
 from pathlib import Path
 
-from lionagi.libs.file.create_path import create_path
+from lionagi.utils import create_path
 
 from .process import dir_to_files
 

{lionagi-0.12.2 → lionagi-0.12.4}/lionagi/libs/file/save.py

@@ -7,7 +7,7 @@ import logging
 from pathlib import Path
 from typing import Any
 
-from .create_path import create_path
+from lionagi.utils import create_path
 
 
 def save_to_file(

lionagi-0.12.4/lionagi/libs/package/imports.py

@@ -0,0 +1,21 @@
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from lionagi.utils import (
+    check_import,
+    import_module,
+    install_import,
+    is_import_installed,
+    run_package_manager_command,
+)
+
+# backward compatibility
+
+__all__ = (
+    "run_package_manager_command",
+    "check_import",
+    "import_module",
+    "install_import",
+    "is_import_installed",
+)

lionagi-0.12.4/lionagi/libs/parse.py

@@ -0,0 +1,30 @@
+# Copyright (c) 2023 - 2025, HaiyangLi <quantocean.li at gmail dot com>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from lionagi.libs.schema.as_readable import as_readable
+from lionagi.libs.schema.extract_code_block import extract_code_block
+from lionagi.libs.schema.function_to_schema import function_to_schema
+from lionagi.libs.validate.fuzzy_match_keys import fuzzy_match_keys
+from lionagi.libs.validate.fuzzy_validate_mapping import fuzzy_validate_mapping
+from lionagi.libs.validate.string_similarity import string_similarity
+from lionagi.utils import fuzzy_parse_json, to_dict, to_json, to_num
+
+validate_keys = fuzzy_match_keys  # for backward compatibility
+validate_mapping = fuzzy_validate_mapping  # for backward compatibility
+
+
+__all__ = (
+    "as_readable",
+    "extract_code_block",
+    "function_to_schema",
+    "fuzzy_match_keys",
+    "fuzzy_validate_mapping",
+    "string_similarity",
+    "validate_keys",
+    "validate_mapping",
+    "to_dict",
+    "to_json",
+    "to_num",
+    "fuzzy_parse_json",
+)