Use a simpler pattern.

Author: robholland

.gitignore

@@ -107,4 +107,3 @@ __pypackages__/
 # Keep lockfiles tracked in this repo (uv.lock is committed), so do NOT ignore them.
 # uv: no special ignores required beyond virtualenvs above
 
-config.toml

agents/openai_agents_sdk_python/README.md

@@ -96,7 +96,6 @@ We configure the Temporal client with the `OpenAIAgentsPlugin` to enable OpenAI
 ```python
 import asyncio
 from datetime import timedelta
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -108,15 +107,10 @@ from activities.tools import get_weather, calculate_circle_area
 
 async def worker_main():
     # Use the plugin to configure Temporal for use with OpenAI Agents SDK
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         plugins=[
             OpenAIAgentsPlugin(
                 model_params=ModelActivityParameters(
@@ -147,7 +141,6 @@ It uses the `OpenAIAgentsPlugin` to match the Worker configuration.
 
 ```python
 import asyncio
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.envconfig import ClientConfig
@@ -156,15 +149,10 @@ from temporalio.contrib.openai_agents import OpenAIAgentsPlugin
 from workflows.hello_world_workflow import HelloWorldAgent
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         # Use the plugin to configure Temporal for use with OpenAI Agents SDK
         plugins=[OpenAIAgentsPlugin()],
     )
@@ -197,24 +185,19 @@ if __name__ == "__main__":
 
 This recipe uses Temporal's environment configuration system to connect to Temporal. By default, it connects to a local Temporal server. To use Temporal Cloud:
 
-1. Copy the example configuration file from the ai-cookbook root:
+1. Set the `TEMPORAL_PROFILE` environment variable to use the cloud profile:
    ```bash
-   cp ../../config.toml.example ../../config.toml
+   export TEMPORAL_PROFILE=cloud
    ```
 
-2. Edit `config.toml` in the ai-cookbook root and update the `[profile.cloud]` section with your Temporal Cloud credentials:
-   - Set `address` to your Temporal Cloud namespace address
-   - Set `namespace` to your namespace name
-   - For authentication, choose one of:
-     - Set `api_key` to your Temporal Cloud API key, or
-     - Set `client_cert_path` and `client_key_path` in the `[profile.cloud.tls]` section to use TLS certificates
-
-3. Set the `TEMPORAL_PROFILE` environment variable to use the cloud profile:
+2. Configure the cloud profile using the Temporal CLI:
    ```bash
-   export TEMPORAL_PROFILE=cloud
+   temporal config set --profile cloud --prop address --value "CLOUD_REMOTE_ADDRESS"
+   temporal config set --profile cloud --prop namespace --value "CLOUD_NAMESPACE"
+   temporal config set --profile cloud --prop api_key --value "CLOUD_API_KEY"
    ```
 
-The code will automatically use `config.toml` if it exists, otherwise it falls back to `config.toml.example`.
+   For TLS certificate authentication instead of API key, refer to the [Temporal environment configuration documentation](https://docs.temporal.io/develop/environment-configuration) for details.
 
 ## Running
 

agents/openai_agents_sdk_python/start_workflow.py

@@ -1,5 +1,4 @@
 import asyncio
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.envconfig import ClientConfig
@@ -9,15 +8,10 @@
 from workflows.hello_world_workflow import HelloWorldAgent
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         # Use the plugin to configure Temporal for use with OpenAI Agents SDK
         plugins=[OpenAIAgentsPlugin()],
     )

agents/openai_agents_sdk_python/worker.py

@@ -1,6 +1,5 @@
 import asyncio
 from datetime import timedelta
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -14,15 +13,10 @@
 
 async def worker_main():
     # Use the plugin to configure Temporal for use with OpenAI Agents SDK
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         plugins=[
             OpenAIAgentsPlugin(
                 model_params=ModelActivityParameters(

agents/tool_call_openai_python/README.md

@@ -243,7 +243,6 @@ The worker is the process that dispatches work to the various parts of the agent
 
 ```python
 import asyncio
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -255,17 +254,10 @@ from temporalio.contrib.pydantic import pydantic_data_converter
 
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    profile = os.environ.get("TEMPORAL_PROFILE", "default")
-    connect_config = ClientConfig.load_client_connect_config(
-        profile=profile,
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )
 
@@ -295,7 +287,6 @@ In order to interact with this simple AI agent, we create a Temporal client and
 ```python
 import asyncio
 import sys
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.envconfig import ClientConfig
@@ -305,17 +296,10 @@ from temporalio.contrib.pydantic import pydantic_data_converter
 
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    profile = os.environ.get("TEMPORAL_PROFILE", "default")
-    connect_config = ClientConfig.load_client_connect_config(
-        profile=profile,
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )
 
@@ -339,24 +323,19 @@ if __name__ == "__main__":
 
 This recipe uses Temporal's environment configuration system to connect to Temporal. By default, it connects to a local Temporal server. To use Temporal Cloud:
 
-1. Copy the example configuration file from the ai-cookbook root:
+1. Set the `TEMPORAL_PROFILE` environment variable to use the cloud profile:
    ```bash
-   cp ../../config.toml.example ../../config.toml
+   export TEMPORAL_PROFILE=cloud
    ```
 
-2. Edit `config.toml` in the ai-cookbook root and update the `[profile.cloud]` section with your Temporal Cloud credentials:
-   - Set `address` to your Temporal Cloud namespace address
-   - Set `namespace` to your namespace name
-   - For authentication, choose one of:
-     - Set `api_key` to your Temporal Cloud API key, or
-     - Set `client_cert_path` and `client_key_path` in the `[profile.cloud.tls]` section to use TLS certificates
-
-3. Set the `TEMPORAL_PROFILE` environment variable to use the cloud profile:
+2. Configure the cloud profile using the Temporal CLI:
    ```bash
-   export TEMPORAL_PROFILE=cloud
+   temporal config set --profile cloud --prop address --value "CLOUD_REMOTE_ADDRESS"
+   temporal config set --profile cloud --prop namespace --value "CLOUD_NAMESPACE"
+   temporal config set --profile cloud --prop api_key --value "CLOUD_API_KEY"
    ```
 
-The code will automatically use `config.toml` if it exists, otherwise it falls back to `config.toml.example`.
+   For TLS certificate authentication instead of API key, refer to the [Temporal environment configuration documentation](https://docs.temporal.io/develop/environment-configuration) for details.
 
 ## Running
 

agents/tool_call_openai_python/start_workflow.py

@@ -1,6 +1,5 @@
 import asyncio
 import sys
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.envconfig import ClientConfig
@@ -10,15 +9,10 @@
 
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )
 

agents/tool_call_openai_python/worker.py

@@ -1,5 +1,4 @@
 import asyncio
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -11,15 +10,10 @@
 
 
 async def main():
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )
 

config.toml.example

@@ -3,7 +3,6 @@
 import uuid
 import os
 from datetime import datetime
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.envconfig import ClientConfig
@@ -14,17 +13,10 @@
 
 async def main():
     # Connect to Temporal server with matching data converter
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    profile = os.environ.get("TEMPORAL_PROFILE", "default")
-    connect_config = ClientConfig.load_client_connect_config(
-        profile=profile,
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )
 

deep_research/basic_openai_python/start_workflow.py

@@ -1,5 +1,4 @@
 import asyncio
-from pathlib import Path
 
 from temporalio.client import Client
 from temporalio.worker import Worker
@@ -12,15 +11,10 @@
 
 async def main():
     # Connect to Temporal server with pydantic data converter for our data classes
-    config_dir = Path(__file__).parent.parent.parent
-    config_file = config_dir / "config.toml"
-    if not config_file.exists():
-        config_file = config_dir / "config.toml.example"
-    connect_config = ClientConfig.load_client_connect_config(
-        config_file=str(config_file)
-    )
+    config = ClientConfig.load_client_connect_config()
+    config.setdefault("target_host", "localhost:7233")
     client = await Client.connect(
-        **connect_config,
+        **config,
         data_converter=pydantic_data_converter,
     )