ni.agentkit 0.3.1__tar.gz

ni_agentkit-0.3.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentKit Contributors
+
+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.

ni_agentkit-0.3.1/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: ni.agentkit
+Version: 0.3.1
+Summary: A Python-native Agent framework with first-class Skill support and multi-LLM adapter
+Author-email: Krix Tam <krix.tam@qq.com>
+License: MIT
+Project-URL: Documentation, https://github.com/KrixTam/AgentKit/tree/main/agentkit/docs
+Project-URL: Repository, https://github.com/KrixTam/AgentKit
+Keywords: agent,llm,skill,ai,framework,tool-use,function-calling
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.30.0; extra == "anthropic"
+Provides-Extra: google
+Requires-Dist: google-genai>=1.0.0; extra == "google"
+Provides-Extra: memory
+Requires-Dist: mem0ai>=0.1.0; extra == "memory"
+Provides-Extra: docker
+Requires-Dist: docker>=7.0.0; extra == "docker"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.30.0; extra == "all"
+Requires-Dist: google-genai>=1.0.0; extra == "all"
+Requires-Dist: mem0ai>=0.1.0; extra == "all"
+Dynamic: license-file
+
+# AgentKit
+
+**Python 原生 Agent 框架，内置一等公民 Skill 支持与多 LLM 适配器。**
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## ✨ 特性
+
+- 🤖 **声明式 Agent** — 零继承配置，支持 Handoff 转介 + as_tool 委派两种协作模式
+- 📚 **一等公民 Skill** — 三级渐进式加载（L1 元数据 → L2 指令 → L3 资源），按需加载省 token
+- 🔧 **灵活工具系统** — `@function_tool` 装饰器自动推断 JSON Schema
+- 🧠 **多 LLM 适配器** — 自研统一适配层，4 个适配器覆盖所有主流 LLM
+- 🛡️ **内置安全** — Guardrail 护栏 + 权限控制 + 三级沙箱
+- 🎭 **编排 Agent** — Sequential / Parallel / Loop 三种模式
+- 💾 **记忆系统** — 可选集成 Mem0，支持自定义记忆提供者
+
+## 🚀 安装
+
+```bash
+# 基础安装（仅核心 + pydantic）
+pip install agentkit
+
+# 按需安装 LLM 适配器
+pip install agentkit[openai]      # OpenAI GPT
+pip install agentkit[anthropic]   # Anthropic Claude
+pip install agentkit[google]      # Google Gemini
+pip install agentkit[all]         # 全部
+```
+
+## ⚡ 30 秒快速开始
+
+```python
+from agentkit import Agent, Runner, function_tool
+
+@function_tool
+def get_weather(city: str) -> str:
+    """获取天气"""
+    return f"{city}：晴，25°C"
+
+agent = Agent(
+    name="assistant",
+    instructions="你是一个有帮助的中文助手。",
+    model="ollama/qwen3.5:cloud",
+    tools=[get_weather],
+)
+
+result = Runner.run_sync(agent, input="北京今天天气如何？")
+print(result.final_output)
+```
+
+## 📚 文档
+
+安装后查看文档：
+
+```bash
+# 命令行方式
+agentkit-docs
+
+# Python 方式
+import agentkit
+print(agentkit.get_docs_dir())     # 文档目录路径
+print(agentkit.get_examples_dir()) # 示例目录路径
+```
+
+| 文档 | 说明 |
+|------|------|
+| [README](docs/README.md) | 项目概述与特性 |
+| [QuickStart](docs/QuickStart.md) | 8 个渐进式入门示例 |
+| [Architecture](docs/Architecture.md) | 六层架构设计说明 |
+| [Reference](docs/Reference.md) | 完整 API 参考手册 |
+
+## 🧪 示例
+
+安装包内含 16 个可运行示例（标准版 × 8 + Ollama 本地版 × 8）：
+
+```bash
+# Ollama 本地版（无需 API Key）
+python -c "import agentkit; print(agentkit.get_examples_dir())"
+# 然后运行对应目录下的示例文件
+
+# 或者直接：
+python -m agentkit.examples.ollama.01_basic_chat
+```
+
+## 🔌 支持的 LLM
+
+| 模型 | 适配器 | 用法 |
+|------|--------|------|
+| GPT-4o / o1 / o3 / o4 | OpenAIAdapter | `model="gpt-4o"` |
+| Claude Opus/Sonnet/Haiku | AnthropicAdapter | `model="claude-sonnet-4-20250514"` |
+| Gemini 2.5 / 3 | GoogleAdapter | `model="gemini-2.5-pro"` |
+| 通义千问/智谱/DeepSeek/Moonshot/百川/Azure | OpenAICompatibleAdapter | `model="deepseek/deepseek-chat"` |
+| Ollama 本地模型 | OllamaAdapter | `model="ollama/qwen3.5:cloud"` |
+
+## 🔨 构建打包
+
+```bash
+./build.sh          # 构建 wheel + sdist
+./build.sh clean    # 清理构建产物
+./build.sh test     # 在隔离环境中安装并验证
+./build.sh all      # 清理 + 构建 + 验证（推荐）
+```
+
+构建产物输出到 `dist/` 目录：
+
+```bash
+dist/
+├── agentkit-0.3.1-py3-none-any.whl   # pip install 用这个
+└── agentkit-0.3.1.tar.gz             # 源码分发
+```
+
+## 📄 License
+
+MIT

ni_agentkit-0.3.1/README.md

@@ -0,0 +1,115 @@
+# AgentKit
+
+**Python 原生 Agent 框架，内置一等公民 Skill 支持与多 LLM 适配器。**
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## ✨ 特性
+
+- 🤖 **声明式 Agent** — 零继承配置，支持 Handoff 转介 + as_tool 委派两种协作模式
+- 📚 **一等公民 Skill** — 三级渐进式加载（L1 元数据 → L2 指令 → L3 资源），按需加载省 token
+- 🔧 **灵活工具系统** — `@function_tool` 装饰器自动推断 JSON Schema
+- 🧠 **多 LLM 适配器** — 自研统一适配层，4 个适配器覆盖所有主流 LLM
+- 🛡️ **内置安全** — Guardrail 护栏 + 权限控制 + 三级沙箱
+- 🎭 **编排 Agent** — Sequential / Parallel / Loop 三种模式
+- 💾 **记忆系统** — 可选集成 Mem0，支持自定义记忆提供者
+
+## 🚀 安装
+
+```bash
+# 基础安装（仅核心 + pydantic）
+pip install agentkit
+
+# 按需安装 LLM 适配器
+pip install agentkit[openai]      # OpenAI GPT
+pip install agentkit[anthropic]   # Anthropic Claude
+pip install agentkit[google]      # Google Gemini
+pip install agentkit[all]         # 全部
+```
+
+## ⚡ 30 秒快速开始
+
+```python
+from agentkit import Agent, Runner, function_tool
+
+@function_tool
+def get_weather(city: str) -> str:
+    """获取天气"""
+    return f"{city}：晴，25°C"
+
+agent = Agent(
+    name="assistant",
+    instructions="你是一个有帮助的中文助手。",
+    model="ollama/qwen3.5:cloud",
+    tools=[get_weather],
+)
+
+result = Runner.run_sync(agent, input="北京今天天气如何？")
+print(result.final_output)
+```
+
+## 📚 文档
+
+安装后查看文档：
+
+```bash
+# 命令行方式
+agentkit-docs
+
+# Python 方式
+import agentkit
+print(agentkit.get_docs_dir())     # 文档目录路径
+print(agentkit.get_examples_dir()) # 示例目录路径
+```
+
+| 文档 | 说明 |
+|------|------|
+| [README](docs/README.md) | 项目概述与特性 |
+| [QuickStart](docs/QuickStart.md) | 8 个渐进式入门示例 |
+| [Architecture](docs/Architecture.md) | 六层架构设计说明 |
+| [Reference](docs/Reference.md) | 完整 API 参考手册 |
+
+## 🧪 示例
+
+安装包内含 16 个可运行示例（标准版 × 8 + Ollama 本地版 × 8）：
+
+```bash
+# Ollama 本地版（无需 API Key）
+python -c "import agentkit; print(agentkit.get_examples_dir())"
+# 然后运行对应目录下的示例文件
+
+# 或者直接：
+python -m agentkit.examples.ollama.01_basic_chat
+```
+
+## 🔌 支持的 LLM
+
+| 模型 | 适配器 | 用法 |
+|------|--------|------|
+| GPT-4o / o1 / o3 / o4 | OpenAIAdapter | `model="gpt-4o"` |
+| Claude Opus/Sonnet/Haiku | AnthropicAdapter | `model="claude-sonnet-4-20250514"` |
+| Gemini 2.5 / 3 | GoogleAdapter | `model="gemini-2.5-pro"` |
+| 通义千问/智谱/DeepSeek/Moonshot/百川/Azure | OpenAICompatibleAdapter | `model="deepseek/deepseek-chat"` |
+| Ollama 本地模型 | OllamaAdapter | `model="ollama/qwen3.5:cloud"` |
+
+## 🔨 构建打包
+
+```bash
+./build.sh          # 构建 wheel + sdist
+./build.sh clean    # 清理构建产物
+./build.sh test     # 在隔离环境中安装并验证
+./build.sh all      # 清理 + 构建 + 验证（推荐）
+```
+
+构建产物输出到 `dist/` 目录：
+
+```bash
+dist/
+├── agentkit-0.3.1-py3-none-any.whl   # pip install 用这个
+└── agentkit-0.3.1.tar.gz             # 源码分发
+```
+
+## 📄 License
+
+MIT

ni_agentkit-0.3.1/__init__.py

@@ -0,0 +1,57 @@
+"""
+agentkit — Python 原生 Agent 框架，内置一等公民 Skill 支持
+
+用法:
+    from agentkit import Agent, Runner, function_tool
+    from agentkit import Skill, load_skill_from_dir
+    from agentkit import LLMRegistry, LLMConfig
+"""
+from .agents.agent import Agent
+from .agents.base_agent import BaseAgent
+from .agents.orchestrators import LoopAgent, ParallelAgent, SequentialAgent
+from .llm.base import BaseLLM
+from .llm.registry import LLMRegistry
+from .llm.types import LLMConfig, LLMResponse, Message, ToolCall, ToolDefinition
+from .memory.base import BaseMemoryProvider, Memory
+from .runner.events import Event, RunResult
+from .runner.runner import Runner
+from .safety.guardrails import (
+    GuardrailResult,
+    InputGuardrail,
+    OutputGuardrail,
+    input_guardrail,
+    output_guardrail,
+)
+from .safety.permissions import PermissionPolicy
+from .skills.loader import load_skill_from_dir
+from .skills.models import Skill, SkillFrontmatter, SkillResources
+from .skills.registry import SkillRegistry
+from .tools.base_tool import BaseTool, BaseToolset
+from .tools.function_tool import FunctionTool, function_tool
+
+__version__ = "0.3.1"
+
+
+def get_docs_dir() -> str:
+    """返回 agentkit 文档目录的绝对路径"""
+    import os
+    return os.path.join(os.path.dirname(__file__), "docs")
+
+
+def get_examples_dir() -> str:
+    """返回 agentkit 示例目录的绝对路径"""
+    import os
+    return os.path.join(os.path.dirname(__file__), "examples")
+
+
+__all__ = [
+    "Agent", "BaseAgent", "SequentialAgent", "ParallelAgent", "LoopAgent",
+    "Runner", "RunResult", "Event",
+    "BaseLLM", "LLMConfig", "LLMRegistry", "LLMResponse", "Message", "ToolCall", "ToolDefinition",
+    "BaseTool", "BaseToolset", "FunctionTool", "function_tool",
+    "Skill", "SkillFrontmatter", "SkillResources", "SkillRegistry", "load_skill_from_dir",
+    "GuardrailResult", "InputGuardrail", "OutputGuardrail", "PermissionPolicy",
+    "input_guardrail", "output_guardrail",
+    "BaseMemoryProvider", "Memory",
+    "get_docs_dir", "get_examples_dir",
+]

ni_agentkit-0.3.1/_cli.py

@@ -0,0 +1,72 @@
+"""
+AgentKit CLI 工具。
+
+安装后提供以下命令：
+  agentkit-docs       — 显示文档目录位置，或在浏览器中打开
+"""
+import os
+
+
+def _get_docs_dir() -> str:
+    """返回 docs 目录的绝对路径"""
+    return os.path.join(os.path.dirname(__file__), "docs")
+
+
+def _get_examples_dir() -> str:
+    """返回 examples 目录的绝对路径"""
+    return os.path.join(os.path.dirname(__file__), "examples")
+
+
+def show_docs():
+    """agentkit-docs 命令入口"""
+    docs_dir = _get_docs_dir()
+    examples_dir = _get_examples_dir()
+
+    print("=" * 60)
+    print("  AgentKit v0.3.1 — 文档与示例")
+    print("=" * 60)
+    print()
+
+    # 文档
+    print("📚 文档目录:")
+    print(f"   {docs_dir}")
+    print()
+
+    if os.path.isdir(docs_dir):
+        print("   文件列表:")
+        for f in sorted(os.listdir(docs_dir)):
+            fpath = os.path.join(docs_dir, f)
+            size = os.path.getsize(fpath) / 1024
+            print(f"     • {f:30s} ({size:.1f} KB)")
+    else:
+        print("   ⚠️  文档目录不存在（包可能未正确安装）")
+
+    print()
+
+    # 示例
+    print("💡 示例目录:")
+    print(f"   {examples_dir}")
+    print()
+
+    if os.path.isdir(examples_dir):
+        for subdir in ["standard", "ollama"]:
+            sub_path = os.path.join(examples_dir, subdir)
+            if os.path.isdir(sub_path):
+                files = [f for f in sorted(os.listdir(sub_path)) if f.endswith(".py") and f != "__init__.py"]
+                print(f"   📁 {subdir}/ ({len(files)} 个示例)")
+                for f in files:
+                    print(f"     • {f}")
+                print()
+
+    print("-" * 60)
+    print("快速开始:")
+    print("  1. 查看文档:  cat $(agentkit-docs-path)/README.md")
+    print("  2. 运行示例:  python -m agentkit.examples.ollama.01_basic_chat")
+    print("  3. Python 中获取路径:")
+    print("     >>> import agentkit; print(agentkit.get_docs_dir())")
+    print("     >>> import agentkit; print(agentkit.get_examples_dir())")
+    print()
+
+
+if __name__ == "__main__":
+    show_docs()