wolfpackai 0.1.0__tar.gz

wolfpackai-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: wolfpackai
+Version: 0.1.0
+Summary: Python framework for AI agents with observability, governance, and a production control plane.
+Author: Wolfpack AI
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/wolfpackaiagents/wolfpackai
+Project-URL: Repository, https://github.com/wolfpackaiagents/wolfpackai
+Project-URL: Issues, https://github.com/wolfpackaiagents/wolfpackai/issues
+Keywords: agents,ai,llm,observability,rag,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=2.0
+Requires-Dist: openai>=1.40
+Requires-Dist: anthropic>=0.34
+Requires-Dist: google-genai>=0.2
+Requires-Dist: opentelemetry-api>=1.25
+Requires-Dist: opentelemetry-sdk>=1.25
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.25
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: cryptography>=42.0
+Provides-Extra: qdrant
+Requires-Dist: qdrant-client>=1.9; extra == "qdrant"
+Provides-Extra: pgvector
+Requires-Dist: pgvector>=0.2; extra == "pgvector"
+Requires-Dist: psycopg[binary]>=3.1; extra == "pgvector"
+Provides-Extra: chroma
+Requires-Dist: chromadb>=0.4; extra == "chroma"
+Provides-Extra: knowledge
+Requires-Dist: pypdf>=4.0; extra == "knowledge"
+Requires-Dist: python-docx>=1.1; extra == "knowledge"
+Requires-Dist: beautifulsoup4>=4.12; extra == "knowledge"
+Requires-Dist: markdown>=3.5; extra == "knowledge"
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.0; extra == "mcp"
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23; extra == "test"
+
+# Wolfpack AI
+
+Wolfpack AI is a Python framework for building production-ready artificial
+intelligence agents. It
+combines agent execution, tool calling, retrieval-augmented generation (RAG),
+memory, human approval flows, guardrails, and OpenTelemetry observability in a
+single developer-focused library.
+
+Every agent run can emit structured traces for model calls, tool executions,
+token usage, latency, and cost. The optional Wolfpack Agent Management Platform
+(AMP) receives those traces and provides an operational interface for
+monitoring, governance, evaluation, and agent lifecycle management.
+
+## Install
+
+Wolfpack AI requires Python 3.10 or later.
+
+```bash
+pip install wolfpackai
+```
+
+The published package is named `wolfpackai`; Python imports remain under the
+stable `wolfpack` module.
+
+Install optional integrations as needed:
+
+```bash
+pip install "wolfpackai[qdrant]"    # Qdrant vector database
+pip install "wolfpackai[pgvector]"  # PostgreSQL vector search
+pip install "wolfpackai[knowledge]" # Document readers
+pip install "wolfpackai[mcp]"       # Model Context Protocol client
+```
+
+## Quick Start
+
+Configure a supported model provider, then create an agent and attach typed
+Python functions as tools.
+
+```bash
+export OPENAI_API_KEY="..."
+```
+
+```python
+from wolfpack import Agent, get_model_from_env, tool
+
+
+@tool
+def get_weather(city: str) -> str:
+    """Return the current weather for a city.
+
+    Args:
+        city: City name.
+    """
+    return f"{city}: 22 C, cloudy."
+
+
+agent = Agent(
+    name="Weather assistant",
+    model=get_model_from_env(),
+    tools=[get_weather],
+)
+
+result = agent.run("What is the weather in Lisbon?")
+print(result.content)
+```
+
+## Capabilities
+
+- Agent loop with synchronous execution, asynchronous execution, streaming,
+  events, and typed tool calling.
+- Model adapters for OpenAI, Anthropic, Google Gemini, Ollama, Groq, and
+  OpenAI-compatible providers.
+- Knowledge retrieval with chunking, embeddings, and memory, Qdrant, or
+  PostgreSQL vector stores.
+- Persistent session memory with in-memory and SQLite stores.
+- Guardrails for personally identifiable information, prompt injection, and
+  tool allowlists.
+- Durable human-in-the-loop approvals, including pause and resume workflows.
+- Pydantic-based structured output with validation and retry feedback.
+- Deterministic workflows with directed acyclic graph execution, conditions,
+  and retries.
+- Multi-agent teams with delegation, routing, broadcast, and task modes.
+- Model Context Protocol client support for external tool servers.
+- Evaluation runners, score publishing, scheduled tasks, and channel adapters
+  for Telegram, Slack, Discord, and web chat.
+
+## Observability
+
+Wolfpack AI emits OpenTelemetry spans using the generative artificial
+intelligence semantic conventions. Set an Agent Management Platform endpoint
+and project Application Programming Interface key to send runs to the control
+plane:
+
+```bash
+export WOLFPACK_AMP_URL="http://localhost:8000"
+export WOLFPACK_AMP_API_KEY="pk-...:secret"
+```
+
+The Agent Management Platform stores traces and provides dashboards, trace
+exploration, session views, approvals, guardrail settings, evaluation scores,
+privacy controls, schedules, runtime mesh monitoring, and channel management.
+
+## Development
+
+Clone the repository and install the development dependencies with uv:
+
+```bash
+git clone https://github.com/wolfpackaiagents/wolfpackai.git
+cd wolfpackai/framework
+uv sync --extra test --group dev
+pytest
+```
+
+Examples are organized by capability in `examples/`, including basic agents,
+tools, knowledge retrieval, observability, human approval, workflows, teams,
+
+## License
+
+Wolfpack AI is released under the MIT License.

wolfpackai-0.1.0/README.md

@@ -0,0 +1,119 @@
+# Wolfpack AI
+
+Wolfpack AI is a Python framework for building production-ready artificial
+intelligence agents. It
+combines agent execution, tool calling, retrieval-augmented generation (RAG),
+memory, human approval flows, guardrails, and OpenTelemetry observability in a
+single developer-focused library.
+
+Every agent run can emit structured traces for model calls, tool executions,
+token usage, latency, and cost. The optional Wolfpack Agent Management Platform
+(AMP) receives those traces and provides an operational interface for
+monitoring, governance, evaluation, and agent lifecycle management.
+
+## Install
+
+Wolfpack AI requires Python 3.10 or later.
+
+```bash
+pip install wolfpackai
+```
+
+The published package is named `wolfpackai`; Python imports remain under the
+stable `wolfpack` module.
+
+Install optional integrations as needed:
+
+```bash
+pip install "wolfpackai[qdrant]"    # Qdrant vector database
+pip install "wolfpackai[pgvector]"  # PostgreSQL vector search
+pip install "wolfpackai[knowledge]" # Document readers
+pip install "wolfpackai[mcp]"       # Model Context Protocol client
+```
+
+## Quick Start
+
+Configure a supported model provider, then create an agent and attach typed
+Python functions as tools.
+
+```bash
+export OPENAI_API_KEY="..."
+```
+
+```python
+from wolfpack import Agent, get_model_from_env, tool
+
+
+@tool
+def get_weather(city: str) -> str:
+    """Return the current weather for a city.
+
+    Args:
+        city: City name.
+    """
+    return f"{city}: 22 C, cloudy."
+
+
+agent = Agent(
+    name="Weather assistant",
+    model=get_model_from_env(),
+    tools=[get_weather],
+)
+
+result = agent.run("What is the weather in Lisbon?")
+print(result.content)
+```
+
+## Capabilities
+
+- Agent loop with synchronous execution, asynchronous execution, streaming,
+  events, and typed tool calling.
+- Model adapters for OpenAI, Anthropic, Google Gemini, Ollama, Groq, and
+  OpenAI-compatible providers.
+- Knowledge retrieval with chunking, embeddings, and memory, Qdrant, or
+  PostgreSQL vector stores.
+- Persistent session memory with in-memory and SQLite stores.
+- Guardrails for personally identifiable information, prompt injection, and
+  tool allowlists.
+- Durable human-in-the-loop approvals, including pause and resume workflows.
+- Pydantic-based structured output with validation and retry feedback.
+- Deterministic workflows with directed acyclic graph execution, conditions,
+  and retries.
+- Multi-agent teams with delegation, routing, broadcast, and task modes.
+- Model Context Protocol client support for external tool servers.
+- Evaluation runners, score publishing, scheduled tasks, and channel adapters
+  for Telegram, Slack, Discord, and web chat.
+
+## Observability
+
+Wolfpack AI emits OpenTelemetry spans using the generative artificial
+intelligence semantic conventions. Set an Agent Management Platform endpoint
+and project Application Programming Interface key to send runs to the control
+plane:
+
+```bash
+export WOLFPACK_AMP_URL="http://localhost:8000"
+export WOLFPACK_AMP_API_KEY="pk-...:secret"
+```
+
+The Agent Management Platform stores traces and provides dashboards, trace
+exploration, session views, approvals, guardrail settings, evaluation scores,
+privacy controls, schedules, runtime mesh monitoring, and channel management.
+
+## Development
+
+Clone the repository and install the development dependencies with uv:
+
+```bash
+git clone https://github.com/wolfpackaiagents/wolfpackai.git
+cd wolfpackai/framework
+uv sync --extra test --group dev
+pytest
+```
+
+Examples are organized by capability in `examples/`, including basic agents,
+tools, knowledge retrieval, observability, human approval, workflows, teams,
+
+## License
+
+Wolfpack AI is released under the MIT License.

wolfpackai-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wolfpackai"
+version = "0.1.0"
+description = "Python framework for AI agents with observability, governance, and a production control plane."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Wolfpack AI" }]
+keywords = ["agents", "ai", "llm", "observability", "rag", "workflow"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pydantic>=2.0",
+    "openai>=1.40",
+    "anthropic>=0.34",
+    "google-genai>=0.2",
+    "opentelemetry-api>=1.25",
+    "opentelemetry-sdk>=1.25",
+    "opentelemetry-exporter-otlp-proto-http>=1.25",
+    "pyyaml>=6.0",
+    "cryptography>=42.0",
+]
+
+[project.optional-dependencies]
+qdrant = ["qdrant-client>=1.9"]
+pgvector = ["pgvector>=0.2", "psycopg[binary]>=3.1"]
+chroma = ["chromadb>=0.4"]
+knowledge = ["pypdf>=4.0", "python-docx>=1.1", "beautifulsoup4>=4.12", "markdown>=3.5"]
+mcp = ["mcp>=1.0,<2"]
+test = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[tool.uv]
+package = true
+
+[project.urls]
+Homepage = "https://github.com/wolfpackaiagents/wolfpackai"
+Repository = "https://github.com/wolfpackaiagents/wolfpackai"
+Issues = "https://github.com/wolfpackaiagents/wolfpackai/issues"
+
+[tool.setuptools.packages.find]
+include = ["wolfpack*"]

wolfpackai-0.1.0/setup.cfg

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