fakzed 0.1.0__tar.gz

fakzed-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# uv / virtualenv
+.venv/
+
+# Testing
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Env
+.env
+.env.*
+
+# Node / web UI
+node_modules/
+.next/
+apps/ui/out/
+
+# fakzed runtime data (API-key hashes, sessions, runs)
+fakzed_server.json
+*.db
+*.sqlite3
+
+# Local dev notes (contain secrets / working log)
+note.md

fakzed-0.1.0/LICENSE

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

fakzed-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.5
+Name: fakzed
+Version: 0.1.0
+Summary: Fakzed: a lightweight Python framework for building agent platforms. Three primitives (Agent, Team, Workflow) with pluggable capabilities.
+Author: fakzed contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,ai,framework,llm,multi-agent,workflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: mcp>=2.3.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=15.0.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.34; extra == 'anthropic'
+Provides-Extra: deepseek
+Requires-Dist: openai>=1.50; extra == 'deepseek'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.3; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.50; extra == 'openai'
+Provides-Extra: sqlite
+Requires-Dist: sqlalchemy>=2.0; extra == 'sqlite'
+Description-Content-Type: text/markdown
+
+# fakzed
+
+A lightweight Python framework for building agent platforms.
+
+- **Three primitives**: `Agent` (tool loop + multi-turn), `Team` (coordinate /
+  route / collaborate), `Workflow` (sequential / conditional / loop / parallel)
+- **Own model layer**: OpenAI / DeepSeek / Anthropic / Ollama adapters with a
+  registry factory (`"deepseek:deepseek-chat"`), streaming, tool calls,
+  reasoning content, structured output
+- **Pluggable capabilities**: `@tool` + built-ins + MCP client, AgenticMemory,
+  Knowledge RAG, Skills, ContextProvider, Guardrails, Hooks, observability
+- **Runtime**: BackgroundRunner, Scheduler, Evals
+
+```bash
+uv add fakzed            # or: pip install fakzed
+uv add fakzed[deepseek]  # provider extras: openai / anthropic / ollama / deepseek / sqlite
+```
+
+```python
+from fakzed import Agent, tool
+
+
+@tool
+def add(a: int, b: int) -> int:
+    """Add two numbers."""
+    return a + b
+
+
+agent = Agent(name="calc", model="deepseek:deepseek-chat", tools=[add])
+resp = agent.run("1 + 1 = ?")
+print(resp.content)
+```
+
+See the monorepo [README](../../README.md), [docs](../../docs/quickstart.md)
+and [cookbook](../../cookbook/README.md) for the full guide.

fakzed-0.1.0/README.md

@@ -0,0 +1,35 @@
+# fakzed
+
+A lightweight Python framework for building agent platforms.
+
+- **Three primitives**: `Agent` (tool loop + multi-turn), `Team` (coordinate /
+  route / collaborate), `Workflow` (sequential / conditional / loop / parallel)
+- **Own model layer**: OpenAI / DeepSeek / Anthropic / Ollama adapters with a
+  registry factory (`"deepseek:deepseek-chat"`), streaming, tool calls,
+  reasoning content, structured output
+- **Pluggable capabilities**: `@tool` + built-ins + MCP client, AgenticMemory,
+  Knowledge RAG, Skills, ContextProvider, Guardrails, Hooks, observability
+- **Runtime**: BackgroundRunner, Scheduler, Evals
+
+```bash
+uv add fakzed            # or: pip install fakzed
+uv add fakzed[deepseek]  # provider extras: openai / anthropic / ollama / deepseek / sqlite
+```
+
+```python
+from fakzed import Agent, tool
+
+
+@tool
+def add(a: int, b: int) -> int:
+    """Add two numbers."""
+    return a + b
+
+
+agent = Agent(name="calc", model="deepseek:deepseek-chat", tools=[add])
+resp = agent.run("1 + 1 = ?")
+print(resp.content)
+```
+
+See the monorepo [README](../../README.md), [docs](../../docs/quickstart.md)
+and [cookbook](../../cookbook/README.md) for the full guide.

fakzed-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "fakzed"
+version = "0.1.0"
+description = "Fakzed: a lightweight Python framework for building agent platforms. Three primitives (Agent, Team, Workflow) with pluggable capabilities."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "fakzed contributors" }]
+keywords = ["agent", "ai", "llm", "multi-agent", "workflow", "framework"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+
+dependencies = [
+    "mcp>=2.3.0",
+    "pydantic>=2.7",
+    "rich>=15.0.0",
+]
+
+[project.optional-dependencies]
+openai = ["openai>=1.50"]
+anthropic = ["anthropic>=0.34"]
+ollama = ["ollama>=0.3"]
+deepseek = ["openai>=1.50"]
+sqlite = ["sqlalchemy>=2.0"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/fakzed"]

fakzed-0.1.0/src/fakzed/__init__.py

@@ -0,0 +1,113 @@
+"""Fakzed: a lightweight framework for building agent platforms.
+
+Named after Faker's legendary Zed outplay. Three primitives — Agent, Team,
+Workflow — with pluggable capabilities (models, tools, memory, knowledge,
+guardrails), sharing one registration mechanism between SDK and platform.
+"""
+
+from importlib.metadata import version as _version
+
+from fakzed.agent import Agent, MemberInteraction, RunResponse, Team, TeamRoute
+from fakzed.context import ContextProvider, TimeProvider
+from fakzed.evals import EvalCase, EvalReport, eval_agent
+from fakzed.guardrails import (
+    GuardrailError,
+    GuardrailResult,
+    Guardrails,
+    InputGuardrail,
+    OutputGuardrail,
+)
+from fakzed.hooks import Hooks
+from fakzed.knowledge import (
+    Embedder,
+    HashEmbedder,
+    InMemoryVectorDb,
+    KnowledgeBase,
+    OpenAIEmbedder,
+    SearchResult,
+    VectorDb,
+)
+from fakzed.memory import AgenticMemory
+from fakzed.model import Message, Model, create_model
+from fakzed.observability import (
+    EventBus,
+    MetricsCollector,
+    RunEvent,
+    RunMetrics,
+    RunObserver,
+    Trace,
+    Tracer,
+)
+from fakzed.platform import RemoteAgent, RemoteAgentError
+from fakzed.runtime import BackgroundRun, BackgroundRunner, Scheduler
+from fakzed.session import Session
+from fakzed.skills import Skill
+from fakzed.storage import InMemoryStorage, SqliteStorage, Storage
+from fakzed.tools import Tool, tool
+from fakzed.workflow import (
+    IfBlock,
+    LoopBlock,
+    ParallelBlock,
+    Step,
+    Workflow,
+    WorkflowContext,
+    WorkflowResult,
+)
+
+__version__ = _version("fakzed")
+
+__all__ = [
+    "Agent",
+    "RunResponse",
+    "Team",
+    "MemberInteraction",
+    "TeamRoute",
+    "AgenticMemory",
+    "ContextProvider",
+    "TimeProvider",
+    "KnowledgeBase",
+    "Embedder",
+    "HashEmbedder",
+    "OpenAIEmbedder",
+    "VectorDb",
+    "InMemoryVectorDb",
+    "SearchResult",
+    "Message",
+    "Model",
+    "create_model",
+    "Session",
+    "Skill",
+    "Storage",
+    "InMemoryStorage",
+    "SqliteStorage",
+    "Tool",
+    "tool",
+    "Workflow",
+    "Step",
+    "IfBlock",
+    "LoopBlock",
+    "ParallelBlock",
+    "WorkflowContext",
+    "WorkflowResult",
+    "Hooks",
+    "Guardrails",
+    "InputGuardrail",
+    "OutputGuardrail",
+    "GuardrailResult",
+    "GuardrailError",
+    "EventBus",
+    "RunEvent",
+    "RunMetrics",
+    "RunObserver",
+    "MetricsCollector",
+    "Tracer",
+    "Trace",
+    "RemoteAgent",
+    "RemoteAgentError",
+    "BackgroundRunner",
+    "BackgroundRun",
+    "Scheduler",
+    "eval_agent",
+    "EvalCase",
+    "EvalReport",
+]

fakzed-0.1.0/src/fakzed/agent/__init__.py

@@ -0,0 +1,13 @@
+"""Agent primitive: a single model-driven program."""
+
+from fakzed.agent.agent import Agent, AgentMaxIterationsError, RunResponse
+from fakzed.agent.team import MemberInteraction, Team, TeamRoute
+
+__all__ = [
+    "Agent",
+    "AgentMaxIterationsError",
+    "RunResponse",
+    "MemberInteraction",
+    "Team",
+    "TeamRoute",
+]