theforge 0.1.0__tar.gz

theforge-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: theforge
+Version: 0.1.0
+Summary: TheForge SDK — Observability for AI agents
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.24; extra == "httpx"
+Provides-Extra: requests
+Requires-Dist: requests>=2.28; extra == "requests"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask>=2.3; extra == "flask"
+
+# TheForge Python SDK
+
+TheForge Python SDK provides tracing, observability, and local evaluation helpers for AI agents.
+
+## Install
+
+```bash
+pip install theforge
+```
+
+## Quick Start
+
+```python
+from theforge import observe
+
+observe(
+    platform_url="https://your-forge-host",
+    api_key="your-api-key",
+)
+```

theforge-0.1.0/README.md

@@ -0,0 +1,20 @@
+# TheForge Python SDK
+
+TheForge Python SDK provides tracing, observability, and local evaluation helpers for AI agents.
+
+## Install
+
+```bash
+pip install theforge
+```
+
+## Quick Start
+
+```python
+from theforge import observe
+
+observe(
+    platform_url="https://your-forge-host",
+    api_key="your-api-key",
+)
+```

theforge-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "theforge"
+version = "0.1.0"
+description = "TheForge SDK — Observability for AI agents"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+dependencies = []
+
+[project.optional-dependencies]
+httpx = ["httpx>=0.24"]
+requests = ["requests>=2.28"]
+fastapi = ["fastapi>=0.100"]
+flask = ["flask>=2.3"]
+
+[tool.setuptools.packages.find]
+include = ["theforge*"]

theforge-0.1.0/setup.cfg

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

theforge-0.1.0/theforge/__init__.py

@@ -0,0 +1,67 @@
+"""TheForge SDK — Observability for AI agents.
+
+MLflow-style tracing with automatic LLM call capture, parent-child span nesting,
+and multi-framework support (Flask, FastAPI, Django, Starlette).
+
+Usage:
+    from theforge import trace, SpanType, observe
+
+    # Decorator — works at module level before observe() is called
+    @trace(span_type=SpanType.TOOL)
+    async def web_search(query: str) -> str:
+        ...
+
+    # Start observability (call once at app startup)
+    observe(
+        name="My Agent",
+        app=app,  # Flask/FastAPI/Starlette app
+        platform_url="http://localhost:8080",
+        api_key="your-api-key",
+    )
+"""
+
+from theforge._core import (
+    configure,
+    trace,
+    SpanType,
+    observe,
+    start_span,
+    with_span,
+    get_active_span,
+    get_prompt,
+    get_prompt_sync,
+)
+from theforge.eval import (
+    EvalDataset,
+    EvalAPIClient,
+    normalize_dataset,
+    run_eval_dataset,
+    call_agent_http,
+    score_exact_match,
+    score_contains,
+    score_precision_recall_f1,
+    score_json_structural_match,
+    score_cosine_similarity,
+)
+
+__all__ = [
+    "configure",
+    "trace",
+    "SpanType",
+    "observe",
+    "start_span",
+    "with_span",
+    "get_active_span",
+    "get_prompt",
+    "get_prompt_sync",
+    "EvalDataset",
+    "EvalAPIClient",
+    "normalize_dataset",
+    "run_eval_dataset",
+    "call_agent_http",
+    "score_exact_match",
+    "score_contains",
+    "score_precision_recall_f1",
+    "score_json_structural_match",
+    "score_cosine_similarity",
+]