skilllite 0.1.0__tar.gz

skilllite-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SkillLite Team
+
+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.

skilllite-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include pyproject.toml
+recursive-include skilllite *.py

skilllite-0.1.0/PKG-INFO

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: skilllite
+Version: 0.1.0
+Summary: A lightweight Skills execution engine with LLM integration for LLM agents
+Author-email: SkillLite Team <skilllite@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/EXboys/skilllite
+Project-URL: Documentation, https://github.com/EXboys/skilllite#readme
+Project-URL: Repository, https://github.com/EXboys/skilllite
+Project-URL: Issues, https://github.com/EXboys/skilllite/issues
+Keywords: agent,skills,llm,claude,openai,sandbox,tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+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 :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Requires-Dist: mcp>=1.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# SkillLite Python SDK
+
+A Python SDK for the SkillLite execution engine, using **OpenAI-compatible API format** as the unified interface.
+
+## Supported Providers
+
+Works with any OpenAI-compatible LLM provider:
+- **OpenAI** (GPT-4, GPT-3.5, etc.)
+- **Azure OpenAI**
+- **Anthropic Claude** (via OpenAI-compatible endpoint or native)
+- **Google Gemini** (via OpenAI-compatible endpoint)
+- **Local models** (Ollama, vLLM, LMStudio, etc.)
+- **DeepSeek, Qwen, Moonshot, Zhipu**, and other providers
+
+## Installation
+
+```bash
+pip install skilllite
+
+# With OpenAI SDK (recommended, works with all compatible providers)
+pip install skilllite[openai]
+
+# With Anthropic SDK (for Claude's native API)
+pip install skilllite[anthropic]
+```
+
+## Prerequisites
+
+You need to have the `skillbox` binary installed:
+
+```bash
+# From the skillbox directory
+cargo install --path .
+```
+
+## Quick Start
+
+### Basic Usage (Universal - Works with Any Provider)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with ANY OpenAI-compatible provider
+# Just change base_url and api_key for different providers:
+
+# OpenAI
+client = OpenAI()
+
+# Ollama (local)
+# client = OpenAI(base_url="http://localhost:11434/v1", api_key="ollama")
+
+# DeepSeek
+# client = OpenAI(base_url="https://api.deepseek.com/v1", api_key="...")
+
+# Qwen (通义千问)
+# client = OpenAI(base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", api_key="...")
+
+# Moonshot (月之暗面)
+# client = OpenAI(base_url="https://api.moonshot.cn/v1", api_key="...")
+
+# Initialize SkillManager
+manager = SkillManager(skills_dir="./my_skills")
+
+# Get tools (OpenAI-compatible format - works with all providers)
+tools = manager.get_tools()
+
+# Call any OpenAI-compatible API
+response = client.chat.completions.create(
+    model="gpt-4",  # or "llama2", "deepseek-chat", "qwen-turbo", etc.
+    tools=tools,
+    messages=[{"role": "user", "content": "Please help me with..."}]
+)
+
+# Handle tool calls (same code works for all providers!)
+if response.choices[0].message.tool_calls:
+    tool_results = manager.handle_tool_calls(response)
+    
+    # Continue conversation with results
+    messages = [
+        {"role": "user", "content": "Please help me with..."},
+        response.choices[0].message,
+        *[r.to_openai_format() for r in tool_results]
+    ]
+    
+    follow_up = client.chat.completions.create(
+        model="gpt-4",
+        tools=tools,
+        messages=messages
+    )
+```
+
+### Agentic Loop (Automatic Multi-turn Tool Execution)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with any provider
+client = OpenAI()  # or OpenAI(base_url="...", api_key="...")
+manager = SkillManager(skills_dir="./my_skills")
+
+# Create an agentic loop
+loop = manager.create_agentic_loop(
+    client=client,
+    model="gpt-4",
+    system_prompt="You are a helpful assistant with access to various skills.",
+    max_iterations=10,
+    temperature=0.7  # Additional kwargs passed to chat.completions.create()
+)
+
+# Run until completion - handles multiple tool calls automatically
+final_response = loop.run("Please analyze this data and generate a report.")
+print(final_response.choices[0].message.content)
+```
+
+### Claude Native API (Optional)
+
+If you prefer using Claude's native API directly:
+
+```python
+import anthropic
+from skilllite import SkillManager
+
+client = anthropic.Anthropic()
+manager = SkillManager(skills_dir="./my_skills")
+
+# Use Claude-specific methods
+tools = manager.get_tools_for_claude_native()
+response = client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=4096,
+    tools=tools,
+    messages=[{"role": "user", "content": "..."}]
+)
+
+if response.stop_reason == "tool_use":
+    results = manager.handle_tool_calls_claude_native(response)
+```
+
+## Creating Skills
+
+Skills are defined in directories with a `SKILL.md` file:
+
+```
+my_skills/
+├── web-search/
+│   ├── SKILL.md           # Metadata and docs (includes dependency declaration)
+│   └── scripts/
+│       └── main.py
+└── calculator/
+    ├── SKILL.md
+    └── scripts/
+        └── main.py
+```
+
+> **Note**: Python dependencies are declared in the `compatibility` field of `SKILL.md`, not in a separate `requirements.txt` file.
+
+### SKILL.md Format
+
+```markdown
+---
+name: web-search
+description: Search the web for information
+compatibility: Requires Python 3.x with requests library, network access
+license: MIT
+metadata:
+  author: example-org
+  version: "1.0"
+---
+
+# Web Search Skill
+
+This skill searches the web for information.
+
+## Input Parameters
+
+- `query`: The search query (required)
+```
+
+The `compatibility` field is used to:
+- Detect language (Python/Node/Bash)
+- Enable network access (keywords: network, internet, http, api, web)
+- Auto-install dependencies (known packages like requests, pandas, axios, etc.)
+
+### Skill Entry Point
+
+```python
+# main.py
+import json
+import sys
+
+def main():
+    # Read input from stdin
+    input_data = json.loads(sys.stdin.read())
+    
+    # Process the input
+    query = input_data.get("query", "")
+    
+    # Do something...
+    result = {"results": [f"Result for: {query}"]}
+    
+    # Output JSON to stdout
+    print(json.dumps(result))
+
+if __name__ == "__main__":
+    main()
+```
+
+## API Reference
+
+### SkillManager
+
+The main class for managing and executing skills.
+
+#### Constructor
+
+```python
+SkillManager(
+    skills_dir: Optional[str] = None,  # Directory containing skills
+    binary_path: Optional[str] = None,  # Path to skillbox binary
+    cache_dir: Optional[str] = None,    # Cache directory for venvs
+    allow_network: bool = False          # Default network access
+)
+```
+
+#### Methods
+
+- `scan_directory(directory)` - Scan for skills
+- `register_skill(skill_dir)` - Register a single skill
+- `get_skill(name)` - Get skill by name
+- `list_skills()` - List all skills
+- `get_tools_for_claude()` - Get Claude-format tools
+- `get_tools_for_openai()` - Get OpenAI-format tools
+- `execute(skill_name, input_data)` - Execute a skill
+- `handle_tool_calls(response, format)` - Handle LLM tool calls
+- `create_agentic_loop(...)` - Create an agentic loop
+
+### ToolFormat
+
+Enum for LLM provider formats:
+- `ToolFormat.CLAUDE`
+- `ToolFormat.OPENAI`
+
+## License
+
+MIT License

skilllite-0.1.0/README.md

@@ -0,0 +1,247 @@
+# SkillLite Python SDK
+
+A Python SDK for the SkillLite execution engine, using **OpenAI-compatible API format** as the unified interface.
+
+## Supported Providers
+
+Works with any OpenAI-compatible LLM provider:
+- **OpenAI** (GPT-4, GPT-3.5, etc.)
+- **Azure OpenAI**
+- **Anthropic Claude** (via OpenAI-compatible endpoint or native)
+- **Google Gemini** (via OpenAI-compatible endpoint)
+- **Local models** (Ollama, vLLM, LMStudio, etc.)
+- **DeepSeek, Qwen, Moonshot, Zhipu**, and other providers
+
+## Installation
+
+```bash
+pip install skilllite
+
+# With OpenAI SDK (recommended, works with all compatible providers)
+pip install skilllite[openai]
+
+# With Anthropic SDK (for Claude's native API)
+pip install skilllite[anthropic]
+```
+
+## Prerequisites
+
+You need to have the `skillbox` binary installed:
+
+```bash
+# From the skillbox directory
+cargo install --path .
+```
+
+## Quick Start
+
+### Basic Usage (Universal - Works with Any Provider)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with ANY OpenAI-compatible provider
+# Just change base_url and api_key for different providers:
+
+# OpenAI
+client = OpenAI()
+
+# Ollama (local)
+# client = OpenAI(base_url="http://localhost:11434/v1", api_key="ollama")
+
+# DeepSeek
+# client = OpenAI(base_url="https://api.deepseek.com/v1", api_key="...")
+
+# Qwen (通义千问)
+# client = OpenAI(base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", api_key="...")
+
+# Moonshot (月之暗面)
+# client = OpenAI(base_url="https://api.moonshot.cn/v1", api_key="...")
+
+# Initialize SkillManager
+manager = SkillManager(skills_dir="./my_skills")
+
+# Get tools (OpenAI-compatible format - works with all providers)
+tools = manager.get_tools()
+
+# Call any OpenAI-compatible API
+response = client.chat.completions.create(
+    model="gpt-4",  # or "llama2", "deepseek-chat", "qwen-turbo", etc.
+    tools=tools,
+    messages=[{"role": "user", "content": "Please help me with..."}]
+)
+
+# Handle tool calls (same code works for all providers!)
+if response.choices[0].message.tool_calls:
+    tool_results = manager.handle_tool_calls(response)
+    
+    # Continue conversation with results
+    messages = [
+        {"role": "user", "content": "Please help me with..."},
+        response.choices[0].message,
+        *[r.to_openai_format() for r in tool_results]
+    ]
+    
+    follow_up = client.chat.completions.create(
+        model="gpt-4",
+        tools=tools,
+        messages=messages
+    )
+```
+
+### Agentic Loop (Automatic Multi-turn Tool Execution)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with any provider
+client = OpenAI()  # or OpenAI(base_url="...", api_key="...")
+manager = SkillManager(skills_dir="./my_skills")
+
+# Create an agentic loop
+loop = manager.create_agentic_loop(
+    client=client,
+    model="gpt-4",
+    system_prompt="You are a helpful assistant with access to various skills.",
+    max_iterations=10,
+    temperature=0.7  # Additional kwargs passed to chat.completions.create()
+)
+
+# Run until completion - handles multiple tool calls automatically
+final_response = loop.run("Please analyze this data and generate a report.")
+print(final_response.choices[0].message.content)
+```
+
+### Claude Native API (Optional)
+
+If you prefer using Claude's native API directly:
+
+```python
+import anthropic
+from skilllite import SkillManager
+
+client = anthropic.Anthropic()
+manager = SkillManager(skills_dir="./my_skills")
+
+# Use Claude-specific methods
+tools = manager.get_tools_for_claude_native()
+response = client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=4096,
+    tools=tools,
+    messages=[{"role": "user", "content": "..."}]
+)
+
+if response.stop_reason == "tool_use":
+    results = manager.handle_tool_calls_claude_native(response)
+```
+
+## Creating Skills
+
+Skills are defined in directories with a `SKILL.md` file:
+
+```
+my_skills/
+├── web-search/
+│   ├── SKILL.md           # Metadata and docs (includes dependency declaration)
+│   └── scripts/
+│       └── main.py
+└── calculator/
+    ├── SKILL.md
+    └── scripts/
+        └── main.py
+```
+
+> **Note**: Python dependencies are declared in the `compatibility` field of `SKILL.md`, not in a separate `requirements.txt` file.
+
+### SKILL.md Format
+
+```markdown
+---
+name: web-search
+description: Search the web for information
+compatibility: Requires Python 3.x with requests library, network access
+license: MIT
+metadata:
+  author: example-org
+  version: "1.0"
+---
+
+# Web Search Skill
+
+This skill searches the web for information.
+
+## Input Parameters
+
+- `query`: The search query (required)
+```
+
+The `compatibility` field is used to:
+- Detect language (Python/Node/Bash)
+- Enable network access (keywords: network, internet, http, api, web)
+- Auto-install dependencies (known packages like requests, pandas, axios, etc.)
+
+### Skill Entry Point
+
+```python
+# main.py
+import json
+import sys
+
+def main():
+    # Read input from stdin
+    input_data = json.loads(sys.stdin.read())
+    
+    # Process the input
+    query = input_data.get("query", "")
+    
+    # Do something...
+    result = {"results": [f"Result for: {query}"]}
+    
+    # Output JSON to stdout
+    print(json.dumps(result))
+
+if __name__ == "__main__":
+    main()
+```
+
+## API Reference
+
+### SkillManager
+
+The main class for managing and executing skills.
+
+#### Constructor
+
+```python
+SkillManager(
+    skills_dir: Optional[str] = None,  # Directory containing skills
+    binary_path: Optional[str] = None,  # Path to skillbox binary
+    cache_dir: Optional[str] = None,    # Cache directory for venvs
+    allow_network: bool = False          # Default network access
+)
+```
+
+#### Methods
+
+- `scan_directory(directory)` - Scan for skills
+- `register_skill(skill_dir)` - Register a single skill
+- `get_skill(name)` - Get skill by name
+- `list_skills()` - List all skills
+- `get_tools_for_claude()` - Get Claude-format tools
+- `get_tools_for_openai()` - Get OpenAI-format tools
+- `execute(skill_name, input_data)` - Execute a skill
+- `handle_tool_calls(response, format)` - Handle LLM tool calls
+- `create_agentic_loop(...)` - Create an agentic loop
+
+### ToolFormat
+
+Enum for LLM provider formats:
+- `ToolFormat.CLAUDE`
+- `ToolFormat.OPENAI`
+
+## License
+
+MIT License

skilllite-0.1.0/pyproject.toml

@@ -0,0 +1,87 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "skilllite"
+version = "0.1.0"
+description = "A lightweight Skills execution engine with LLM integration for LLM agents"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "SkillLite Team", email = "skilllite@example.com"}
+]
+keywords = ["agent", "skills", "llm", "claude", "openai", "sandbox", "tools"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+openai = ["openai>=1.0.0"]
+anthropic = ["anthropic>=0.18.0"]
+mcp = ["mcp>=1.0.0"]
+all = [
+    "openai>=1.0.0",
+    "anthropic>=0.18.0",
+    "mcp>=1.0.0",
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0",
+    "mypy>=1.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/EXboys/skilllite"
+Documentation = "https://github.com/EXboys/skilllite#readme"
+Repository = "https://github.com/EXboys/skilllite"
+Issues = "https://github.com/EXboys/skilllite/issues"
+
+[project.scripts]
+skilllite = "skilllite.cli:main"
+skilllite-mcp = "skilllite.mcp:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["skilllite*"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]

skilllite-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

skilllite-0.1.0/setup.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python
+"""
+Backwards compatibility setup.py for older pip versions.
+The actual configuration is in pyproject.toml.
+"""
+
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()