synth-ai 0.2.2.dev0__py3-none-any.whl → 0.2.3__py3-none-any.whl

synth_ai/{tracing → v0/tracing}/upload.py

@@ -12,8 +12,8 @@ from pydantic import BaseModel, ConfigDict, field_validator
 from requests.adapters import HTTPAdapter
 from urllib3.poolmanager import PoolManager
 
-from synth_ai.tracing.abstractions import Dataset, SystemTrace
-from synth_ai.tracing.events.store import event_store
+from .abstractions import Dataset, SystemTrace
+from .events.store import event_store
 
 load_dotenv()
 
@@ -370,8 +370,8 @@ def upload_helper(
         raise ValueError("SYNTH_API_KEY environment variable not set")
     base_url = os.getenv("SYNTH_ENDPOINT_OVERRIDE", "https://agent-learning.onrender.com")
 
-    from synth_ai.tracing.decorators import _local, active_events_var
-    from synth_ai.tracing.trackers import synth_tracker_async, synth_tracker_sync
+from .decorators import _local, active_events_var
+from .trackers import synth_tracker_async, synth_tracker_sync
 
     # First close any tracker events
     if hasattr(synth_tracker_async, "active_events"):

synth_ai/v0/tracing_v1/__init__.py

@@ -0,0 +1,16 @@
+import warnings
+
+# Issue deprecation warning when this module is imported
+warnings.warn(
+    "synth_ai.tracing (now tracing_v1) is deprecated. "
+    "Please use synth_ai.tracing_v2 instead. "
+    "Backend upload functionality is no longer supported in v1.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export the main components with deprecation warnings
+from .config import *
+from .decorators import *
+from .trackers import *
+from .abstractions import *

synth_ai/{tracing_v1 → v0/tracing_v1}/base_client.py

@@ -4,9 +4,9 @@ from abc import ABC, abstractmethod
 from dataclasses import dataclass
 from typing import Any, Dict, Optional
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.config import TracingConfig
-from synth_ai.tracing_v1.events.store import event_store
+from .abstractions import Event
+from .config import TracingConfig
+from .events.store import event_store
 
 logger = logging.getLogger(__name__)
 

synth_ai/{tracing_v1 → v0/tracing_v1}/client_manager.py

@@ -6,7 +6,7 @@ from typing import ClassVar, Dict, Optional
 
 import httpx
 
-from synth_ai.tracing_v1.config import TracingConfig
+from .config import TracingConfig
 
 
 class ClientManager:

synth_ai/{tracing_v1 → v0/tracing_v1}/context.py

@@ -3,7 +3,7 @@ import logging
 from contextlib import contextmanager
 from typing import Any, Dict, Generic, Optional, TypeVar
 
-from synth_ai.tracing_v1.local import (
+from .local import (
     _local,
     active_events_var,
     system_id_var,

synth_ai/{tracing_v1 → v0/tracing_v1}/decorators.py

@@ -8,9 +8,9 @@ from functools import wraps
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Literal, ParamSpec, TypeVar, Union
 
 if TYPE_CHECKING:
-    from synth_ai.tracing_v1.trackers import SynthTrackerAsync, SynthTrackerSync
+    from .trackers import SynthTrackerAsync, SynthTrackerSync
 
-from synth_ai.tracing_v1.abstractions import (
+from .abstractions import (
     AgentComputeStep,
     ArbitraryInputs,
     ArbitraryOutputs,
@@ -19,28 +19,28 @@ from synth_ai.tracing_v1.abstractions import (
     MessageInputs,
     MessageOutputs,
 )
-from synth_ai.tracing_v1.config import EventManagement, LoggingMode, Origin, TracingConfig
-from synth_ai.tracing_v1.context import (
+from .config import EventManagement, LoggingMode, Origin, TracingConfig
+from .context import (
     get_current_context,
     trace_context,
 )
-from synth_ai.tracing_v1.events.manage import set_current_event
-from synth_ai.tracing_v1.events.store import event_store
-from synth_ai.tracing_v1.immediate_client import (
+from .events.manage import set_current_event
+from .events.store import event_store
+from .immediate_client import (
     AsyncImmediateLogClient,
     ImmediateLogClient,
 )
-from synth_ai.tracing_v1.local import (
+from .local import (
     _local,
     active_events_var,
     logger,
 )
-from synth_ai.tracing_v1.retry_queue import initialize_retry_queue, retry_queue
-from synth_ai.tracing_v1.trackers import (
+from .retry_queue import initialize_retry_queue, retry_queue
+from .trackers import (
     synth_tracker_async,
     synth_tracker_sync,
 )
-from synth_ai.tracing_v1.utils import get_system_id
+from .utils import get_system_id
 
 logger = logging.getLogger(__name__)
 

synth_ai/{tracing_v1 → v0/tracing_v1}/events/manage.py

@@ -1,9 +1,9 @@
 import time
 from typing import Literal, Optional
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.events.store import event_store
-from synth_ai.tracing_v1.local import _local, logger
+from ..abstractions import Event
+from ..events.store import event_store
+from ..local import _local, logger
 
 
 def get_current_event(event_type: str) -> "Event":
@@ -75,7 +75,7 @@ def set_current_event(event: Optional["Event"], decorator_type: Literal["sync",
             _local.active_events[unique_key] = event  # Unique key for async
 
     else:
-        from synth_ai.tracing_v1.local import (
+        from ..local import (
             active_events_var,
             system_id_var,
             system_instance_id_var,

synth_ai/{tracing_v1 → v0/tracing_v1}/events/scope.py

@@ -1,20 +1,20 @@
 import time
 from contextlib import contextmanager
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.config import LoggingMode
-from synth_ai.tracing_v1.decorators import (
+from ..abstractions import Event
+from ..config import LoggingMode
+from ..decorators import (
     _local,
     clear_current_event,
     get_tracing_config,
     set_current_event,
 )
-from synth_ai.tracing_v1.events.store import event_store
-from synth_ai.tracing_v1.immediate_client import (
+from ..events.store import event_store
+from ..immediate_client import (
     AsyncImmediateLogClient,
     ImmediateLogClient,
 )
-from synth_ai.tracing_v1.local import (
+from ..local import (
     system_id_var,
     system_instance_id_var,
     system_name_var,

synth_ai/{tracing_v1 → v0/tracing_v1}/events/store.py

@@ -4,8 +4,8 @@ import time
 from threading import RLock  # Change this import
 from typing import Any, Dict, List
 
-from synth_ai.tracing_v1.abstractions import Event, EventPartitionElement, SystemTrace
-from synth_ai.tracing_v1.local import (  # Import context variables
+from ..abstractions import Event, EventPartitionElement, SystemTrace
+from ..local import (  # Import context variables
     _local,
     active_events_var,
 )
@@ -36,7 +36,7 @@ class EventStore:
                 # Get system_instance_metadata from context if available
                 system_instance_metadata = {}
                 try:
-                    from synth_ai.tracing_v1.context import get_current_context
+                    from ..context import get_current_context
 
                     context = get_current_context()
                     if (

synth_ai/{tracing_v1 → v0/tracing_v1}/immediate_client.py

@@ -5,10 +5,10 @@ from typing import Dict
 
 import httpx
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.client_manager import ClientManager
-from synth_ai.tracing_v1.config import TracingConfig
-from synth_ai.tracing_v1.log_client_base import BaseAsyncLogClient, BaseLogClient
+from .abstractions import Event
+from .client_manager import ClientManager
+from .config import TracingConfig
+from .log_client_base import BaseAsyncLogClient, BaseLogClient
 
 logger = logging.getLogger(__name__)
 
@@ -22,7 +22,7 @@ class ImmediateLogClient(BaseLogClient):
 
     def send_event(self, event: Event, system_info: Dict[str, str]) -> bool:
         """Send a single event with retries and fallback"""
-        from synth_ai.tracing_v1.retry_queue import (
+        from .retry_queue import (
             retry_queue,  # Import here to avoid circular import
         )
 
@@ -73,7 +73,7 @@ class AsyncImmediateLogClient(BaseAsyncLogClient):
 
     async def send_event(self, event: Event, system_info: Dict[str, str]) -> bool:
         """Send a single event with retries and fallback (async version)"""
-        from synth_ai.tracing_v1.retry_queue import retry_queue
+        from .retry_queue import retry_queue
 
         if not self.config.api_key:
             logger.error("No API key provided")

synth_ai/{tracing_v1 → v0/tracing_v1}/log_client_base.py

@@ -1,7 +1,7 @@
 from typing import Dict
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.config import TracingConfig
+from .abstractions import Event
+from .config import TracingConfig
 
 
 class BaseLogClient:

synth_ai/{tracing_v1 → v0/tracing_v1}/retry_queue.py

@@ -5,8 +5,8 @@ from collections import deque
 from dataclasses import dataclass
 from typing import Dict, List, Optional, Tuple
 
-from synth_ai.tracing_v1.abstractions import Event
-from synth_ai.tracing_v1.config import TracingConfig
+from .abstractions import Event
+from .config import TracingConfig
 
 logger = logging.getLogger(__name__)
 
@@ -88,7 +88,7 @@ class RetryQueue:
         failure_count = 0
 
         try:
-            from synth_ai.tracing_v1.immediate_client import (
+            from .immediate_client import (
                 ImmediateLogClient,  # Import here to avoid circular import
             )
 

synth_ai/{tracing_v1 → v0/tracing_v1}/trackers.py

@@ -4,8 +4,8 @@ from typing import Any, Dict, List, Literal, Optional, Tuple, Union
 
 from pydantic import BaseModel
 
-from synth_ai.tracing_v1.config import VALID_TYPES, Message, ModelParams
-from synth_ai.tracing_v1.local import _local
+from .config import VALID_TYPES, Message, ModelParams
+from .local import _local
 
 # Existing SynthTrackerSync and SynthTrackerAsync classes...
 

synth_ai/{tracing_v1 → v0/tracing_v1}/upload.py

@@ -13,8 +13,8 @@ from pydantic import BaseModel, ConfigDict, field_validator
 from requests.adapters import HTTPAdapter
 from urllib3.poolmanager import PoolManager
 
-from synth_ai.tracing_v1.abstractions import Dataset, SystemTrace
-from synth_ai.tracing_v1.events.store import event_store
+from .abstractions import Dataset, SystemTrace
+from .events.store import event_store
 
 load_dotenv()
 
@@ -390,8 +390,8 @@ def upload_helper(
         raise ValueError("SYNTH_API_KEY environment variable not set")
     base_url = os.getenv("SYNTH_ENDPOINT_OVERRIDE", "https://agent-learning.onrender.com")
 
-    from synth_ai.tracing_v1.decorators import _local, active_events_var
-    from synth_ai.tracing_v1.trackers import synth_tracker_async, synth_tracker_sync
+    from .decorators import _local, active_events_var
+    from .trackers import synth_tracker_async, synth_tracker_sync
 
     # First close any tracker events
     if hasattr(synth_tracker_async, "active_events"):

{synth_ai-0.2.2.dev0.dist-info → synth_ai-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.2.2.dev0
+Version: 0.2.3
 Summary: Software for aiding the best and multiplying the will - Core AI functionality and tracing
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
@@ -18,7 +18,7 @@ Requires-Dist: tqdm>=4.66.4
 Requires-Dist: jsonschema>=4.23.0
 Requires-Dist: backoff>=2.0.0
 Requires-Dist: typing_extensions>=4.0.0
-Requires-Dist: openai==1.63.0
+Requires-Dist: openai>=1.99.0
 Requires-Dist: anthropic>=0.42.0
 Requires-Dist: langfuse<3.0.0,>=2.53.9
 Requires-Dist: opentelemetry-api>=1.27.0
@@ -45,6 +45,10 @@ Requires-Dist: google-api-core>=2.25.1
 Requires-Dist: google-generativeai>=0.8.5
 Requires-Dist: crafter>=1.8.3
 Requires-Dist: click>=8.1.0
+Requires-Dist: textual>=1.1.0
+Requires-Dist: openai-harmony>=0.0.1
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: aiohttp>=3.8.0
 Provides-Extra: dev
 Requires-Dist: build>=1.2.2.post1; extra == "dev"
 Requires-Dist: twine>=4.0.0; extra == "dev"
@@ -103,5 +107,95 @@ pip install synth-ai[all]
 ```
 
 ### Spinning Up
-uv run python -m uvicorn synth_ai.environments.service.app:app --host 0.0.0.0 --port 8901
-uvpm synth_ai.environments.examples.crafter_classic.agent_demos.test_crafter_react_agent --model gemini-1.5-flash
+
+Start the Synth AI service daemon (includes sqld database + environment service):
+
+```bash
+# Start both database daemon (port 8080) and environment service (port 8901)
+uvx synth-ai serve
+```
+
+#### Service Command Options
+
+```bash
+uvx synth-ai serve [OPTIONS]
+```
+
+**Available Options:**
+- `--db-file` - Database file path (default: "synth_ai.db")
+- `--sqld-port` - Port for sqld HTTP interface (default: 8080)  
+- `--env-port` - Port for environment service (default: 8901)
+- `--no-sqld` - Skip starting sqld database daemon
+- `--no-env` - Skip starting environment service
+
+**Examples:**
+```bash
+# Start with custom ports
+uvx synth-ai serve --sqld-port 8081 --env-port 8902
+
+# Start only the environment service
+uvx synth-ai serve --no-sqld
+
+# Start only the database service
+uvx synth-ai serve --no-env
+```
+
+#### What the Serve Command Provides
+
+**sqld Database Service (port 8080)**
+- Local SQLite-compatible database server with HTTP API
+- Automatically downloads and installs sqld binary if needed
+- Provides persistent storage for agent interactions and traces
+
+**Environment Service (port 8901)**
+- FastAPI service for managing AI environments and tasks
+- Built-in environments: Crafter, Sokoban, MiniGrid, TicTacToe, Verilog, NetHack, Enron
+- RESTful API for environment initialization, stepping, and termination
+- Dynamic environment registry for custom environments
+
+In another terminal, run your first example:
+
+```bash
+# Run a Crafter agent demo with Gemini
+./examples/run_crafter_demo.sh
+```
+
+This will:
+- Start the sqld database daemon with HTTP API on port 8080
+- Launch the environment service API on port 8901  
+- Run a reactive agent in the Crafter environment using Gemini 1.5 Flash
+
+#### Demos (Eval + Finetuning)
+
+You can run interactive demos from the repo without remembering exact commands:
+
+```bash
+# Lists all available demos under examples/, then prompts you to choose
+uvx synth-ai demo
+```
+
+Today this includes:
+- Eval demo: `examples/evals/run_demo.sh`
+  - Prompts for models, episodes, etc.
+  - Runs Crafter rollouts with v3 tracing, then analyzes and filters traces
+  - Writes a JSONL like `ft_data/evals_filtered.jsonl` for downstream use
+- Finetuning demo: `examples/finetuning/synth_qwen/run_demo.sh`
+  - Guides you through: rollouts → filter v3 traces → prepare SFT JSONL
+  - Pair with `uvpm examples.finetuning.synth_qwen.sft_kickoff` to start an SFT job when ready
+
+Notes:
+- Ensure the service is running (`uvx synth-ai serve`) so v3 traces are recorded locally.
+- Set API configuration for finetuning:
+  - `export LEARNING_V2_BASE_URL="http://localhost:8000/api"` (or your proxy)
+  - `export SYNTH_API_KEY="sk_live_..."`
+- v3 trace data is stored under `traces/v3/synth_ai.db/` by default. Inspect with `uvx synth-ai traces`.
+
+### One-Command Demos
+
+Quickly browse and launch interactive demos under `examples/`:
+
+```bash
+uvx synth-ai demo
+```
+
+This lists all `run_demo.sh` scripts found in the repo (e.g., eval comparisons, finetuning flows) and lets you pick one to run.