tracia 0.0.1__py3-none-any.whl → 0.1.0__py3-none-any.whl

tracia-0.1.0.dist-info/METADATA

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: tracia
+Version: 0.1.0
+Summary: LLM prompt management and tracing SDK
+Project-URL: Homepage, https://tracia.io
+Project-URL: Documentation, https://docs.tracia.io
+Project-URL: Repository, https://github.com/tracia/tracia-python
+Project-URL: Issues, https://github.com/tracia/tracia-python/issues
+Author-email: Tracia <hello@tracia.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,anthropic,chatgpt,claude,gemini,google,litellm,llm,observability,openai,prompt,tracing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: litellm>=1.30.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Tracia
+
+**LLM prompt management and tracing SDK for Python**
+
+[![PyPI version](https://badge.fury.io/py/tracia.svg)](https://badge.fury.io/py/tracia)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is Tracia?
+
+Tracia is a modern LLM prompt management and tracing platform. This Python SDK provides:
+
+- **Unified LLM Access** - Call OpenAI, Anthropic, Google, and 100+ providers through a single interface (powered by LiteLLM)
+- **Automatic Tracing** - Every LLM call is automatically traced with latency, token usage, and cost
+- **Prompt Management** - Store, version, and manage your prompts in the cloud
+- **Session Linking** - Easily link related calls for multi-turn conversations
+
+## Installation
+
+```bash
+pip install tracia
+```
+
+You'll also need API keys for the LLM providers you want to use:
+```bash
+export OPENAI_API_KEY="sk-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+export GOOGLE_API_KEY="..."
+```
+
+## Quick Start
+
+```python
+from tracia import Tracia
+
+# Initialize the client
+client = Tracia(api_key="your_tracia_api_key")
+
+# Run a local prompt
+result = client.run_local(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+print(result.text)
+print(f"Tokens: {result.usage.total_tokens}")
+```
+
+## Streaming
+
+```python
+# Stream the response
+stream = client.run_local(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Tell me a story"}],
+    stream=True
+)
+
+for chunk in stream:
+    print(chunk, end="", flush=True)
+
+# Get the final result (stream.result is a Future[StreamResult])
+final = stream.result.result()
+print(f"\nTotal tokens: {final.usage.total_tokens}")
+```
+
+## Multi-turn Conversations with Sessions
+
+```python
+# Create a session for linked conversations
+session = client.create_session()
+
+# First message
+r1 = session.run_local(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "My name is Alice"}]
+)
+
+# Follow-up - automatically linked to the same trace
+r2 = session.run_local(
+    model="gpt-4o",
+    messages=[
+        {"role": "user", "content": "My name is Alice"},
+        {"role": "assistant", "content": r1.text},
+        {"role": "user", "content": "What's my name?"}
+    ]
+)
+```
+
+## Function Calling
+
+```python
+from tracia import ToolDefinition, ToolParameters, JsonSchemaProperty
+
+# Define a tool
+tools = [
+    ToolDefinition(
+        name="get_weather",
+        description="Get the current weather",
+        parameters=ToolParameters(
+            properties={
+                "location": JsonSchemaProperty(
+                    type="string",
+                    description="City name"
+                )
+            },
+            required=["location"]
+        )
+    )
+]
+
+result = client.run_local(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "What's the weather in Paris?"}],
+    tools=tools
+)
+
+if result.tool_calls:
+    for call in result.tool_calls:
+        print(f"Tool: {call.name}, Args: {call.arguments}")
+```
+
+## Variable Interpolation
+
+```python
+result = client.run_local(
+    model="gpt-4o",
+    messages=[
+        {"role": "system", "content": "You are a helpful assistant named {{name}}."},
+        {"role": "user", "content": "Hello!"}
+    ],
+    variables={"name": "Claude"}
+)
+```
+
+## Prompts API
+
+```python
+# List all prompts
+prompts = client.prompts.list()
+
+# Get a specific prompt
+prompt = client.prompts.get("my-prompt")
+
+# Run a prompt template
+result = client.prompts.run(
+    "my-prompt",
+    variables={"name": "World"}
+)
+```
+
+## Spans API
+
+```python
+from tracia import Eval, EvaluateOptions
+
+# List spans
+spans = client.spans.list()
+
+# Evaluate a span
+client.spans.evaluate(
+    "sp_xxx",
+    EvaluateOptions(
+        evaluator="quality",
+        value=Eval.POSITIVE,  # or Eval.NEGATIVE
+        note="Great response!",
+    ),
+)
+```
+
+## Async Support
+
+All methods have async variants:
+
+```python
+import asyncio
+
+async def main():
+    async with Tracia(api_key="...") as client:
+        result = await client.arun_local(
+            model="gpt-4o",
+            messages=[{"role": "user", "content": "Hello!"}]
+        )
+        print(result.text)
+
+asyncio.run(main())
+```
+
+## Supported Providers
+
+Via LiteLLM, Tracia supports 100+ providers including:
+
+- **OpenAI**: gpt-4o, gpt-4, gpt-3.5-turbo, o1, o3
+- **Anthropic**: claude-3-opus, claude-sonnet-4, claude-3-haiku
+- **Google**: gemini-2.0-flash, gemini-2.5-pro
+- And many more...
+
+## Error Handling
+
+```python
+from tracia import TraciaError, TraciaErrorCode
+
+try:
+    result = client.run_local(...)
+except TraciaError as e:
+    if e.code == TraciaErrorCode.MISSING_PROVIDER_API_KEY:
+        print("Please set your API key")
+    elif e.code == TraciaErrorCode.PROVIDER_ERROR:
+        print(f"LLM error: {e.message}")
+```
+
+## Configuration Options
+
+```python
+client = Tracia(
+    api_key="...",
+    base_url="https://app.tracia.io",  # Custom API URL
+    on_span_error=lambda e, span_id: print(f"Span error: {e}")
+)
+
+result = client.run_local(
+    model="gpt-4o",
+    messages=[...],
+    temperature=0.7,
+    max_output_tokens=1000,
+    timeout_ms=30000,
+    tags=["production"],
+    user_id="user_123",
+    session_id="session_456",
+    send_trace=True,  # Set to False to disable tracing
+)
+```
+
+## Learn More
+
+- Website: [tracia.io](https://tracia.io)
+- Documentation: [docs.tracia.io](https://docs.tracia.io)
+- GitHub: [github.com/tracia](https://github.com/tracia)
+
+## License
+
+MIT

tracia-0.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+tracia/__init__.py,sha256=i3fAcuJjd3QVuXHRGLVmNsQW4VirnHL_dNUpLWL4xPE,3538
+tracia/_client.py,sha256=5bTui8EN_vQ9XA9ZxGnkxTWpG2fIseWwdrVGHRmlRbE,40127
+tracia/_constants.py,sha256=vM9X3TLawroFqrFLme_SuYrUgboDu7q2NMyvW_JNQTg,821
+tracia/_errors.py,sha256=NEmqucrx3NqGjYFtelHJw1rs2lvRJky6Xave5bNOswg,2464
+tracia/_http.py,sha256=KE7_vFUpfCHeWewiCqrROw_vCRU9pOpN2i4ieNsOkdI,11237
+tracia/_llm.py,sha256=kv3uU4FcVWhYd-N2m5xsp5rnFY7i-NgbCjv4yqh9RRk,31071
+tracia/_session.py,sha256=6ET-ibGKbU7Sd0o75zPI1O4bRXEqmbD5MMExPO6DO-Y,6903
+tracia/_streaming.py,sha256=qrTTYWY9P39n1a4dh2vKQedgohdMJA7sAHy39YtLGoE,3873
+tracia/_types.py,sha256=XeLNvW32VVv5vVP6BTGC07h9iz21s-KcT2lFxs0yD84,15294
+tracia/_utils.py,sha256=xB28NRFHcduv2k0N3PXIh7sYCwtDU35R1gCiPwdmvvU,3090
+tracia/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tracia/resources/__init__.py,sha256=llZvQRPlEsHDsOdpWcCLgBSPjrJALFltAFThZii3NaY,127
+tracia/resources/prompts.py,sha256=pVNKBRnGAft7JH3HapXYFZN37eO8_9NG7kpXbau1iVA,7553
+tracia/resources/spans.py,sha256=zpF21NeJw_FR8TPVj3nR7r0-FZIzWUycol0n5XoMuTg,6591
+tracia-0.1.0.dist-info/METADATA,sha256=mBVXXalffBkWQMLcQ8AdKYpnyZmmssqcceBq5YRaauA,7033
+tracia-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+tracia-0.1.0.dist-info/licenses/LICENSE,sha256=jnoLcro_uevZVCUf3nkyE43c6mG6MGNJ_3_TShNJj5s,1063
+tracia-0.1.0.dist-info/RECORD,,

tracia-0.0.1.dist-info/METADATA

@@ -1,52 +0,0 @@
-Metadata-Version: 2.4
-Name: tracia
-Version: 0.0.1
-Summary: LLM prompt management and tracing SDK - Coming soon
-Project-URL: Homepage, https://tracia.io
-Project-URL: Repository, https://github.com/tracia/tracia-python
-Project-URL: Issues, https://github.com/tracia/tracia-python/issues
-Author-email: Tracia <hello@tracia.io>
-License-Expression: MIT
-License-File: LICENSE
-Keywords: ai,anthropic,chatgpt,claude,gemini,google,llm,observability,openai,prompt,tracing
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-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
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-
-# Tracia
-
-**LLM prompt management and tracing SDK**
-
-🚀 **Coming soon** - Full SDK launching in early 2026.
-
-## What is Tracia?
-
-Tracia is a modern LLM prompt management and tracing platform with zero-config setup. Store your prompts in the cloud, trace every LLM call, and iterate faster.
-
-## Quick Preview
-
-```python
-from tracia import Tracia
-
-client = Tracia()
-response = client.run("my-prompt", variables={"name": "World"})
-```
-
-## Learn More
-
-- 🌐 Website: [tracia.io](https://tracia.io)
-- 📖 Docs: Coming soon
-- 🐙 GitHub: [github.com/tracia](https://github.com/tracia)
-
-## License
-
-MIT

tracia-0.0.1.dist-info/RECORD

@@ -1,5 +0,0 @@
-tracia/__init__.py,sha256=LOfccReusbDjJkitNMUSvGb5X18iBZv-Zrka7ryRD5o,148
-tracia-0.0.1.dist-info/METADATA,sha256=TUNipf7P_IObyy1xDumTKu1HfS_dGfszMFZdNkzi2D8,1643
-tracia-0.0.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tracia-0.0.1.dist-info/licenses/LICENSE,sha256=jnoLcro_uevZVCUf3nkyE43c6mG6MGNJ_3_TShNJj5s,1063
-tracia-0.0.1.dist-info/RECORD,,