Metadata-Version: 2.4
Name: autourgos-llmagentkit
Version: 1.0.2
Summary: An advanced LLM agent framework supporting ReAct and Tool Calling paradigms.
Author-email: Autourgos Developer <developer@autourgos.com>
License: Copyright (c) 2026 Autourgos. All rights reserved.
        
        PROPRIETARY LICENSE
        
        This software and associated documentation files (the "Software") are the proprietary property of Autourgos.
        
        1. Non-Commercial Use Only:
           The Software is provided for personal, educational, and internal research purposes only. Commercial use, including but not limited to using the Software to provide paid services, selling the Software, or integrating the Software into a commercial product, is strictly prohibited without a separate commercial license agreement.
        
        2. No Resale:
           You may not sell, rent, lease, sublicense, or otherwise distribute the Software or any derivative works for a fee.
        
        3. Redistribution:
           Redistribution of the Software in source or binary forms is permitted provided that:
           - The above copyright notice and this permission notice appear in all copies.
           - The Software is not sold or used for commercial gain.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        
Project-URL: Homepage, https://github.com/autourgos/autourgos-llmagentkit
Project-URL: Repository, https://github.com/autourgos/autourgos-llmagentkit
Project-URL: Bug Tracker, https://github.com/autourgos/autourgos-llmagentkit/issues
Keywords: llm,agent,react,tool-calling,ai,reasoning,automation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: isort>=5.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: ruff>=0.0.260; extra == "dev"
Requires-Dist: twine>=4.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Dynamic: license-file

# Autourgos LLM Agent Kit

**Autourgos LLM Agent Kit** is a powerful, lightweight framework for building advanced AI agents. It supports both **ReAct (Reasoning + Acting)** and **Tool Calling** paradigms, allowing developers to create intelligent agents that can reason through complex problems and execute tools effectively.

## Features

-   **ReAct Agent:** Implements the reasoning-trace loop (Thought → Action → Observation) for complex problem-solving.
-   **Tool Calling Agent:** Optimized for sequential tool execution without explicit reasoning overhead.
-   **Autourgos Core:** A robust tool management system with the `@tool` decorator for easy function-to-tool conversion.
-   **Memory Integration:** Optional conversation memory support.
-   **Customizable Prompts:** Easily modify agent behavior with custom prompt templates.
-   **Verbose Logging:** Detailed colored terminal output for debugging and monitoring agent thought processes.

## Installation

Install via pip:

```bash
pip install autourgos-llmagentkit
```

## Quick Start

### 1. Define Tools

Use the `@tool` decorator from `autourgos.core` to turn Python functions into tools.

```python
from autourgos.core import tool

@tool
def calculate(expression: str) -> str:
    """Evaluates a mathematical expression."""
    return str(eval(expression))

@tool
def search(query: str) -> str:
    """Searches for information about the query."""
    return f"Results for: {query}"
```

### 2. Create a ReAct Agent

The ReAct agent reasons about the user's request and decides which tools to call.

```python
from autourgos.llmagentkit import Create_ReAct_Agent

# Initialize your LLM client (must implement generate_response method)
# llm = MyLLMClient(...)

agent = Create_ReAct_Agent(llm=llm, verbose=True)
agent.add_tools(calculate, search)

response = agent.invoke("What is the calculation for 25 * 4 and search for its significance?")
print(response)
```

### 3. Create a Tool Calling Agent

For more direct tasks where explicit reasoning steps are less critical.

```python
from autourgos.llmagentkit import Create_ToolCalling_Agent

agent = Create_ToolCalling_Agent(llm=llm, verbose=True)
agent.add_tools(calculate)

response = agent.invoke("Calculate 100 / 5")
print(response)
```

## Project Structure

-   `autourgos.llmagentkit`: Core agent implementations (ReAct, Tool Calling).
-   `autourgos.core`: Tool management and decorators.

## License

This project is licensed under a proprietary license. See the `LICENSE` file for details.
Not for resale or commercial use without permission.
