local-agent-toolkit 0.1.0__tar.gz

local_agent_toolkit-0.1.0/.env.example

@@ -0,0 +1,41 @@
+# Local Agent Toolkit Environment Configuration
+# Copy this file to .env and fill in your values
+
+# Agent Configuration
+# Choose which AI agent to use: OLLAMA or OPENAI
+CURRENT_AGENT=OLLAMA
+
+# Ollama Configuration
+# Model name to use with Ollama (e.g., llama3.1, codellama, etc.)
+OLLAMA_MODEL=llama3.1
+# Ollama server URL
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_HOST=http://localhost:11434
+
+# OpenAI Configuration
+# Your OpenAI API key (required only if using OPENAI agent)
+OPENAI_API_KEY=your_openai_api_key_here
+# OpenAI API base URL (optional, for custom endpoints)
+OPENAI_API_BASE=https://api.openai.com/v1
+# OpenAI model to use (optional, defaults to gpt-4 in the code)
+OPENAI_MODEL=gpt-4
+
+# Legacy/Alternative API Configuration
+API_BASE_URL=http://localhost:5000
+
+# Tool and Processing Configuration
+# Maximum iterations for tool calls to prevent infinite loops
+MAX_ITERATIONS=25
+
+# Directory for file operations (optional, defaults to current directory)
+WORK_DIRECTORY=./
+
+# Logging Configuration (optional)
+LOG_LEVEL=INFO
+LOG_FILE=agent.log
+
+# Advanced Configuration (optional)
+# Maximum tool call depth to prevent infinite loops
+MAX_TOOL_CALLS=10
+# Request timeout in seconds
+REQUEST_TIMEOUT=30

local_agent_toolkit-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+  release:
+    types: [published]
+  workflow_dispatch:  
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Check package
+      run: twine check dist/*
+    
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi  
+    permissions:
+      id-token: write 
+    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'release' && github.event.action == 'published')
+    
+    steps:
+    - name: Download artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+    
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      # Note: No 'with' section for trusted publishing - that's the key!

local_agent_toolkit-0.1.0/.gitignore

@@ -0,0 +1,79 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+debug.log
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# VS Code
+.vscode/
+
+# Local env files
+.env
+
+# MacOS
+.DS_Store

local_agent_toolkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TechnicalHeist
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

local_agent_toolkit-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include requirements.txt
+include *.py
+recursive-include helper *.py
+recursive-include agents *.py
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store
+prune __test__

local_agent_toolkit-0.1.0/PKG-INFO

@@ -0,0 +1,416 @@
+Metadata-Version: 2.4
+Name: local-agent-toolkit
+Version: 0.1.0
+Summary: A sophisticated AI agent toolkit supporting multiple AI providers with tool calling capabilities.
+Home-page: https://technicalheist.com
+Author: TechnicalHeist
+Author-email: TechnicalHeist <contact@technicalheist.com>
+License: MIT
+Project-URL: Homepage, https://technicalheist.com
+Project-URL: Repository, https://github.com/technicalheist/local-agent-toolkit
+Project-URL: Issues, https://github.com/technicalheist/local-agent-toolkit/issues
+Keywords: ai,agent,toolkit,ollama,openai,tool-calling,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ollama>=0.1.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: openai>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.8; extra == "dev"
+Requires-Dist: build>=0.8.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Local Agent Toolkit
+
+[![PyPI version](https://badge.fury.io/py/local-agent-toolkit.svg)](https://badge.fury.io/py/local-agent-toolkit)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A sophisticated AI agent toolkit that can use various tools to answer questions and perform tasks. The toolkit supports multiple AI providers including Ollama and OpenAI, and can be used both as a command-line tool and as a Python library.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install local-agent-toolkit
+```
+
+### Command Line Usage
+
+```bash
+# Ask a question directly
+local-agent "What files are in the current directory?"
+
+# Interactive mode
+local-agent
+
+# With custom settings
+local-agent "Analyze the code structure" --no-save --no-stream
+```
+
+### Python Library Usage
+
+```python
+from local_agent_toolkit import run_agent_with_question
+
+# Simple usage
+result, messages = run_agent_with_question("List all Python files in the project")
+print(result)
+
+# With custom options
+result, messages = run_agent_with_question(
+    question="What's the weather like?",
+    save_messages=False,
+    stream=False
+)
+```
+
+## ✨ Features
+
+- **🤖 Multiple AI Agent Support**: Choose between Ollama and OpenAI agents
+- **🛠️ Rich Tool Integration**: File operations, internet search, shell commands, and more
+- **💻 Dual Interface**: Command-line tool and Python library
+- **📝 Conversation History**: Automatic saving with customizable options
+- **⚙️ Flexible Configuration**: Environment-based configuration for different AI providers
+- **🔄 Streaming Support**: Real-time response streaming (Ollama)
+- **🐍 Python 3.8+**: Compatible with modern Python versions
+
+## 📦 Installation Options
+
+### From PyPI (Recommended)
+```bash
+pip install local-agent-toolkit
+```
+
+### From Source
+```bash
+git clone https://github.com/technicalheist/local-agent-toolkit.git
+cd local-agent-toolkit
+pip install -e .
+```
+
+### Development Installation
+```bash
+git clone https://github.com/technicalheist/local-agent-toolkit.git
+cd local-agent-toolkit
+pip install -e ".[dev]"
+```
+
+## Project Structure
+
+```
+agent/
+├── app.py                    # Main application entry point
+├── agents/                   # AI agent implementations
+│   ├── OllamaAgent.py       # Ollama-based agent
+│   └── OpenAIAgent.py       # OpenAI-based agent
+├── helper/                   # Helper modules directory
+│   ├── __init__.py          # Package initialization
+│   ├── agent.py             # Core agent logic
+│   ├── tools.py             # Tool implementations
+│   ├── tools_definition.py  # Tool definitions
+│   └── tool_call.py         # Function for running the agent
+├── __test__/                 # Test files
+│   ├── ollama_agent_test.py  # Tests for Ollama agent
+│   └── openai_agent_test.py  # Tests for OpenAI agent
+├── requirements.txt          # Python dependencies
+├── .env                     # Environment variables
+└── README.md               # This file
+```
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project root (copy from `.env.example`):
+
+```bash
+# Agent Selection
+CURRENT_AGENT=OLLAMA  # or OPENAI
+
+# Ollama Configuration  
+OLLAMA_MODEL=llama3.1
+OLLAMA_BASE_URL=http://localhost:11434
+
+# OpenAI Configuration
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_MODEL=gpt-4
+
+# Optional Settings
+MAX_ITERATIONS=25
+WORK_DIRECTORY=./
+LOG_LEVEL=INFO
+```
+
+### Supported AI Providers
+
+#### 🦙 Ollama Agent
+- **Purpose**: Local AI models with privacy
+- **Requirements**: Ollama server running locally
+- **Models**: Any Ollama-compatible model (llama3.1, codellama, etc.)
+- **Benefits**: Privacy, no API costs, offline usage
+
+#### 🤖 OpenAI Agent  
+- **Purpose**: Cloud-based AI with latest models
+- **Requirements**: OpenAI API key
+- **Models**: GPT-4, GPT-3.5-turbo, etc.
+- **Benefits**: High performance, latest capabilities
+
+## 🛠️ Available Tools
+
+The agents have access to these built-in tools:
+
+- **📁 File Operations**: `list_files`, `read_file`, `write_file`
+- **🔍 Pattern Search**: `list_files_by_pattern`
+- **🌐 Internet Search**: `ask_any_question_internet`
+- **💻 Shell Commands**: `execute_shell_command`
+- **📂 Directory Operations**: `mkdir`
+
+## 📚 Usage Examples
+
+### Command Line Interface
+
+```bash
+# Basic usage
+local-agent "What Python files are in this project?"
+
+# Interactive mode with conversation history
+local-agent
+
+# Disable features
+local-agent "Analyze code" --no-save --no-stream
+
+# Custom message file
+local-agent "Help me debug" --messages custom_conversation.json
+```
+
+### Python Library
+
+```python
+# Basic usage
+from local_agent_toolkit import run_agent_with_question
+
+result, messages = run_agent_with_question(
+    "Create a Python script that lists all files"
+)
+
+# Advanced usage with options
+result, messages = run_agent_with_question(
+    question="What's the project structure?",
+    save_messages=True,
+    messages_file="project_analysis.json",
+    stream=False
+)
+
+# Using specific agents
+from local_agent_toolkit import OllamaAgent, OpenAIAgent
+from local_agent_toolkit.helper.tools_definition import tools
+
+# Create Ollama agent
+ollama_agent = OllamaAgent(
+    tool_definitions=tools,
+    tool_callables=available_functions
+)
+
+# Create OpenAI agent  
+openai_agent = OpenAIAgent(
+    tool_definitions=tools,
+    tool_callables=available_functions
+)
+```
+
+### Environment Management
+
+#### Option 1: Global .env file
+```bash
+# Create .env in your project root
+cp .env.example .env
+# Edit .env with your settings
+```
+
+#### Option 2: Per-project configuration
+```python
+import os
+from dotenv import load_dotenv
+
+# Load from specific path
+load_dotenv('/path/to/your/project/.env')
+
+# Or set programmatically
+os.environ['CURRENT_AGENT'] = 'OPENAI'
+os.environ['OPENAI_API_KEY'] = 'your_key_here'
+
+from local_agent_toolkit import run_agent_with_question
+```
+
+#### Option 3: Docker/Container deployment
+```dockerfile
+# Dockerfile
+FROM python:3.11-slim
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install local-agent-toolkit
+
+# Set environment variables
+ENV CURRENT_AGENT=OLLAMA
+ENV OLLAMA_BASE_URL=http://ollama-server:11434
+ENV OLLAMA_MODEL=llama3.1
+
+COPY . .
+CMD ["local-agent"]
+```
+
+## 🔧 Development
+
+### Running Tests
+```bash
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest __test__/
+
+# Run specific tests
+pytest __test__/ollama_agent_test.py
+pytest __test__/openai_agent_test.py
+```
+
+### Building for Distribution
+```bash
+# Install build tools
+pip install build twine
+
+# Build the package
+python -m build
+
+# Upload to PyPI (maintainers only)
+twine upload dist/*
+```
+
+## 📝 Project Structure
+
+```
+local-agent-toolkit/
+├── app.py                    # Command-line interface
+├── agents/                   # AI agent implementations
+│   ├── OllamaAgent.py       # Ollama-based agent
+│   └── OpenAIAgent.py       # OpenAI-based agent
+├── helper/                   # Core library modules
+│   ├── __init__.py          # Library exports
+│   ├── agent.py             # Base agent logic
+│   ├── tools.py             # Tool implementations
+│   ├── tools_definition.py  # Tool schemas
+│   └── tool_call.py         # Main execution function
+├── __test__/                 # Test suite
+├── requirements.txt          # Dependencies
+├── setup.py                 # Package configuration
+├── pyproject.toml           # Modern packaging config
+└── .env.example             # Environment template
+```
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- [Ollama](https://ollama.ai/) for local AI model serving
+- [OpenAI](https://openai.com/) for API access to advanced models
+- The Python community for excellent tooling and libraries
+
+## 📞 Support
+
+- 📧 Issues: [GitHub Issues](https://github.com/technicalheist/local-agent-toolkit/issues)
+- 📖 Documentation: [GitHub Repository](https://github.com/technicalheist/local-agent-toolkit)
+- 💬 Discussions: [GitHub Discussions](https://github.com/technicalheist/local-agent-toolkit/discussions)
+
+Use command-line flags for more control:
+
+```bash
+# Ask a question using the --question flag
+python app.py --question "What files are in the helper directory?"
+
+# Don't save the conversation history
+python app.py --question "Get current time" --no-save
+
+# Save to a custom file
+python app.py --question "Create a test directory" --messages-file "my_conversation.json"
+```
+
+## Command-Line Options
+
+- `question` (positional): The question to ask the agent
+- `-q, --question`: Alternative way to specify the question
+- `--no-save`: Don't save the conversation history to a file
+- `--messages-file`: Custom filename for saving conversation history (default: `messages.json`)
+- `-h, --help`: Show help message
+
+## Examples
+
+```bash
+# Interactive mode
+python app.py
+
+# Simple question
+python app.py "What's the weather like?"
+
+# With custom options
+python app.py -q "List directory contents" --messages-file "dir_check.json"
+
+# Without saving conversation
+python app.py "Quick calculation: 2+2" --no-save
+```
+
+## Available Tools
+
+The agent has access to various tools including:
+
+- **File Operations**: `list_files`, `read_file`, `write_file`, `mkdir`
+- **Pattern Matching**: `list_files_by_pattern`
+- **Internet Search**: `ask_any_question_internet`
+- **Shell Commands**: `execute_shell_command`
+
+## Conversation History
+
+By default, all conversations are saved to `messages.json`. You can:
+- Use `--no-save` to skip saving
+- Use `--messages-file` to specify a custom filename
+- View the conversation history in JSON format
+
+## Notes
+
+- The agent can handle complex multi-step tasks
+- **Multiple AI Providers**: Choose between Ollama (local) and OpenAI (cloud) agents based on your needs
+- Conversations include tool calls and responses for full transparency
+- The JSON conversation files can be used for debugging or analysis
+- The agent will continue working until it completes the task or reaches the maximum iteration limit
+- Both agent types support the same tool set and functionality