datalayer · echarles · Jul 27, 2026 · Jul 30, 2026 · Aug 1, 2026 · Aug 1, 2026
diff --git a/src/README.md → DEV.md b/src/README.md → DEV.md
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 [![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
 
-# ☰ 〇 Datalayer Core
+# ☰ ⭕ Datalayer Core
 
 <p align="center">
   <strong>Python and Typescript libraries for Datalayer</strong>
@@ -18,7 +18,7 @@
 
 ## Overview
 
-Datalayer Core is the foundational package that powers the [Datalayer AI Platform](https://datalayer.app/). It provides a TypesScript and Python packages as a Command Line Interface (CLI) for AI engineers, data scientists, and researchers to seamlessly integrate scalable compute runtimes into their workflows.
+Datalayer Core is the foundational package that powers the [Datalayer AI Platform](https://datalayer.ai). It provides a TypesScript and Python packages as a Command Line Interface (CLI) for AI engineers, data scientists, and researchers to seamlessly integrate scalable compute runtimes into their workflows.
 
 This package serves as the base foundation used by many other Datalayer packages, containing core application classes, configuration, and unified APIs for authentication, runtime management, and code execution in cloud-based environments.
 
@@ -66,8 +66,6 @@ npm install
 
 ## Quick Start with Python
 
-### 1. Authentication
-
 Set your Datalayer token as an environment variable:
 
 ```bash
@@ -89,31 +87,19 @@ if client.authenticate():
     print("Successfully authenticated!")
 ```
 
-### 2. Runtime, Snapshots, and Evals
-
-Runtime execution, snapshot workflows, and evals CLI are now documented and maintained in:
+## Architecture
 
-- [agent-runtimes README](https://github.com/datalayer/agent-runtimes/blob/main/README.md)
-- [agent-runtimes CLI docs](https://agent-runtimes.datalayer.tech/cli)
+Datalayer Core serves as the foundation for the entire Datalayer ecosystem:
 
-Use `agent-runtimes` for runtime workloads (`RuntimeClient`, `@datalayer`, snapshots, and evals), and use `datalayer-core` for account/platform operations (authentication, secrets, API keys, usage, profile).
+- **Base Classes**: Core application classes inherited by other Datalayer packages
+- **Configuration Management**: Centralized configuration system for all Datalayer components
+- **Authentication Layer**: Unified authentication across all Datalayer services
+- **Runtime Abstraction**: Common interface for different types of compute runtimes
+- **Resource Management**: Automatic cleanup and lifecycle management
 
 ## Examples
 
-Examples have moved to Agent Runtimes:
-
-- [Agent Runtimes examples README](https://github.com/datalayer/agent-runtimes/blob/main/examples/README.md)
-- [Agent Runtimes examples directory](https://github.com/datalayer/agent-runtimes/tree/main/examples)
-
-## Platform Integration
-
-Datalayer adds AI capabilities and scalable compute runtimes to your development workflows. The platform is designed to seamlessly integrate into your existing processes and supercharge your computations with the processing power you need.
-
-Key platform features accessible through this Client and CLI:
-
-- **Remote Runtimes**: Execute code on powerful remote machines with CPU, RAM, and GPU resources
-- **Multiple Interfaces**: Access and consume runtimes through Python Client, CLI, or other integrated tools
-- **Scalable Compute**: Dynamically scale your computational resources based on workload requirements
+- [OTEL example README](./examples/otel/README.md)
 
 ## Documentation
 
@@ -193,16 +179,6 @@ This Client is designed to be simple and extensible. We welcome contributions! P
 
 For issues and enhancement requests, please use the [GitHub issue tracker](https://github.com/datalayer/core/issues).
 
-## Architecture
-
-Datalayer Core serves as the foundation for the entire Datalayer ecosystem:
-
-- **Base Classes**: Core application classes inherited by other Datalayer packages
-- **Configuration Management**: Centralized configuration system for all Datalayer components
-- **Authentication Layer**: Unified authentication across all Datalayer services
-- **Runtime Abstraction**: Common interface for different types of compute runtimes
-- **Resource Management**: Automatic cleanup and lifecycle management
-
 ## Use Cases
 
 - **AI/ML Development**: Scale your machine learning workflows with cloud compute using Client or CLI
@@ -219,15 +195,16 @@ This project is licensed under the [BSD 3-Clause License](https://github.com/dat
 
 - **Documentation**: [Datalayer Platform Documentation](https://datalayer.ai/docs/)
 - **Issues**: [GitHub Issues](https://github.com/datalayer/core/issues)
-- **Community**: [Datalayer Platform](https://datalayer.app/)
+- **Community**: [Datalayer Platform](https://datalayer.ai)
 
 ---
 
-<p align="center">
-  <img src="https://assets.datalayer.tech/datalayer-25.svg" alt="Datalayer Logo" width="200"></img>
-</p>
+<div align="center">
 
-<p align="center">
-  <strong>🚀 AI Agents for Data Analysis</strong><br></br>
-  <a href="https://datalayer.app/">Get started with Datalayer today!</a>
-</p>
+**If this project is helpful to you, please give us a ⭐️**
+
+Made with ❤️ by [Datalayer](https://datalayer.ai)
+
+<img src="https://assets.datalayer.tech/datalayer-25.svg" alt="Datalayer Logo" width="200"></img>
+
+</div>
diff --git a/datalayer_core/authn/authn.py b/datalayer_core/authn/authn.py
@@ -40,13 +40,14 @@ def __init__(self, iam_url: str, storage: Optional[TokenStorage] = None):
         """
         self.iam_url = iam_url
 
-        # Extract datalayer_url from iam_url (remove /api/iam/v1 suffix if present)
-        datalayer_url = iam_url.replace("/api/iam/v1", "")
+        # The service URL the credentials are stored under: the IAM one,
+        # without the path of its API.
+        service_url = iam_url.replace("/api/iam/v1", "")
 
-        # CRITICAL: Pass datalayer_url as service_name to KeyringStorage for backwards compatibility
+        # CRITICAL: Pass the service URL as service_name to KeyringStorage for backwards compatibility
         self.storage: TokenStorage
         if storage is None:
-            keyring_storage = KeyringStorage(service_name=datalayer_url)
+            keyring_storage = KeyringStorage(service_name=service_url)
             if keyring_storage.is_available():
                 self.storage = keyring_storage
             else:

diff --git a/datalayer_core/authn/server/__main__.py b/datalayer_core/authn/server/__main__.py
@@ -9,23 +9,23 @@
 from typing import Optional
 
 from datalayer_core.authn.server.http_server import get_token
-from datalayer_core.utils.urls import DEFAULT_DATALAYER_URL
+from datalayer_core.utils.urls import DEFAULT_DATALAYER_IAM_URL
 
 logging.basicConfig(level=logging.INFO)
 
 logger = logging.getLogger(__name__)
 
 
-DATALAYER_URL = DEFAULT_DATALAYER_URL
+IAM_URL = DEFAULT_DATALAYER_IAM_URL
 
 
 if __name__ == "__main__":
     from sys import argv
 
     if len(argv) == 2:
-        ans = get_token(DATALAYER_URL, port=int(argv[1]))
+        ans = get_token(IAM_URL, port=int(argv[1]))
     else:
-        ans = get_token(DATALAYER_URL)
+        ans = get_token(IAM_URL)
 
     handle: Optional[str] = None
     token: Optional[str] = None

diff --git a/datalayer_core/authn/server/http_server.py b/datalayer_core/authn/server/http_server.py
@@ -152,7 +152,7 @@ def do_GET(self) -> None:
         elif path in {"/", "/datalayer/login/cli"}:
             config_json = json.dumps(
                 {
-                    "datalayerUrl": self.server.datalayer_url,  # type: ignore
+                    "iamUrl": self.server.iam_url,  # type: ignore
                     "iamUrl": self.server.iam_url,  # type: ignore
                     "whiteLabel": False,
                 }
@@ -229,8 +229,8 @@ class AuthHTTPServer(HTTPServer):
         The server address and port.
     RequestHandlerClass : Callable
         The request handler class.
-    datalayer_url : str
-        The runtime URL.
+    iam_url : str
+        The URL of the IAM service, which the login goes through.
     bind_and_activate : bool, default True
         Whether to bind and activate the server.
     """
@@ -239,7 +239,7 @@ def __init__(
         self,
         server_address: tuple[Union[str, bytes, bytearray], int],
         RequestHandlerClass: t.Callable[[t.Any, t.Any, t.Self], BaseRequestHandler],
-        datalayer_url: str,
+        iam_url: str,
         bind_and_activate: bool = True,
     ) -> None:
         """
@@ -251,14 +251,13 @@ def __init__(
             The server address and port.
         RequestHandlerClass : Callable
             The request handler class.
-        datalayer_url : str
-            The runtime URL.
+        iam_url : str
+            The URL of the IAM service, which the login goes through.
         bind_and_activate : bool, default True
             Whether to bind and activate the server.
         """
         # Use DatalayerURLs for proper URL configuration
-        self._urls = DatalayerURLs.from_environment(datalayer_url=datalayer_url)
-        self.datalayer_url = self._urls.datalayer_url
+        self._urls = DatalayerURLs.from_environment(iam_url=iam_url)
         self.iam_url = self._urls.iam_url
         self.user_handle = None
         self.token = None
@@ -299,15 +298,15 @@ def finish_request(self, request: t.Any, client_address: str) -> None:
 
 
 def get_token(
-    datalayer_url: str, port: Optional[int] = None, logger: logging.Logger = logger
+    iam_url: str, port: Optional[int] = None, logger: logging.Logger = logger
 ) -> Optional[tuple[str, str]]:
     """
     Get the user handle and token.
 
     Parameters
     ----------
-    datalayer_url : str
-        The runtime URL.
+    iam_url : str
+        The URL of the IAM service, which the login goes through.
     port : int or None, default None
         The port to use for the authentication server.
     logger : logging.Logger, default logger
@@ -329,8 +328,8 @@ def get_token(
         )
         sys.argv = [
             "",
-            "--DatalayerExtensionApp.datalayer_url",
-            datalayer_url,
+            "--DatalayerExtensionApp.iam_url",
+            iam_url,
             "--ServerApp.disable_check_xsrf",
             "True",
         ]
@@ -339,7 +338,7 @@ def get_token(
         #        return None if httpd.token is None else (httpd.user_handle, httpd.token)
         return None
     else:
-        httpd = AuthHTTPServer(server_address, LoginRequestHandler, datalayer_url)
+        httpd = AuthHTTPServer(server_address, LoginRequestHandler, iam_url)
         logger.info(
             f"Waiting for user logging, open http://localhost:{port}. Press CTRL+C to abort.\n"
         )

diff --git a/datalayer_core/authn/storage.py b/datalayer_core/authn/storage.py
@@ -60,7 +60,7 @@ def __init__(self, service_name: str = DEFAULT_DATALAYER_IAM_URL):
         """Initialize keyring storage.
 
         Args:
-            service_name: Service name for keyring entries (MUST be datalayer_url for backwards compatibility)
+            service_name: Service name for keyring entries (MUST be the IAM URL for backwards compatibility)
         """
         self.service_name = service_name
         self._keyring: Any = None