renaming project

Author: sha1cybr

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing
 
-Thank you for considering contributing to agentspy! We welcome contributions to improve this project. For general contributions and community guidelines, please see the [repo](https://github.com/cyberark/community/).
+Thank you for considering contributing to agentwatch! We welcome contributions to improve this project. For general contributions and community guidelines, please see the [repo](https://github.com/cyberark/community/).
 ## General Steps for Contributing
 
 1. Fork the project.  

MANIFEST.in

@@ -3,7 +3,7 @@ include LICENSE
 include pyproject.toml
 include setup.cfg
 include setup.py
-recursive-include src/agentspy *.py
+recursive-include src/agentwatch *.py
 recursive-include tests *.py
 recursive-include examples *.py
 recursive-include docs *.md

NOTICES.txt

@@ -1,6 +1,6 @@
 Copyright (c) 2025 CyberArk Software Ltd. All rights reserved
 
-agentspy is using the following open source components:
+agentwatch is using the following open source components:
 
 1) pydantic (https://github.com/pydantic/pydantic): MIT License  
 Copyright (c) 2017 to present Pydantic Services Inc. and individual contributors. 

README.md

@@ -1,18 +1,18 @@
 <p align="center">
-    <img src="resources/logo.png" alt="agentspy - AI Agent Observability Platform" width="400"/>
+    <img src="resources/logo.png" alt="agentwatch - AI Agent Observability Platform" width="400"/>
 </p>
-<h3 align="center" style="font-family: 'Fira Mono', Monospace;">agentspy</h3>
+<h3 align="center" style="font-family: 'Fira Mono', Monospace;">agentwatch</h3>
 <h3 align="center" style="font-family: 'Fira Mono', Monospace;">Platform-Agnostic Agentic AI Runtime Observability Framework</h3>
 
 <p align="center">
-    <a href="https://github.com/cyberark/agentspy/commits/main">
-        <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/cyberark/agentspy">
+    <a href="https://github.com/cyberark/agentwatch/commits/main">
+        <img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/cyberark/agentwatch">
     </a>
-    <a href="https://github.com/cyberark/agentspy">
-        <img alt="GitHub code size" src="https://img.shields.io/github/languages/code-size/cyberark/agentspy">
+    <a href="https://github.com/cyberark/agentwatch">
+        <img alt="GitHub code size" src="https://img.shields.io/github/languages/code-size/cyberark/agentwatch">
     </a>
-    <a href="https://github.com/cyberark/agentspy/blob/master/LICENSE">
-        <img alt="Apache License" src="https://img.shields.io/github/license/cyberark/agentspy">
+    <a href="https://github.com/cyberark/agentwatch/blob/master/LICENSE">
+        <img alt="Apache License" src="https://img.shields.io/github/license/cyberark/agentwatch">
     </a>
     <a href="https://discord.gg/Zt297RAK">
         <img alt="Join Discord Community" src="https://img.shields.io/discord/1330486843938177157">
@@ -21,10 +21,10 @@
 
 ## 🌟 Overview
 
-agentspy is a cutting-edge observability framework designed to provide deep insights into AI agent interactions across diverse platforms and frameworks. By seamlessly intercepting, logging, and analyzing interactions, agentspy empowers developers to understand and optimize their AI-driven applications with unprecedented visibility.
+agentwatch is a cutting-edge observability framework designed to provide deep insights into AI agent interactions across diverse platforms and frameworks. By seamlessly intercepting, logging, and analyzing interactions, agentwatch empowers developers to understand and optimize their AI-driven applications with unprecedented visibility.
 
 <p align="center">
-    <img src="resources/agentspy.gif" alt="agentspy Demonstration" width="800"/>
+    <img src="resources/agentwatch.gif" alt="agentwatch Demonstration" width="800"/>
 </p>
 
 ## ✨ Key Features
@@ -42,25 +42,25 @@ agentspy is a cutting-edge observability framework designed to provide deep insi
 - Any other framework or library which uses an LLM :D
 
 ## 📦 Prerequisites
-To ensure compatibility with agentspy, your application must be written in Python. The visualization UI will be built locally on your endpoint using npm,
+To ensure compatibility with agentwatch, your application must be written in Python. The visualization UI will be built locally on your endpoint using npm,
 so make sure you have the following installed:
 
 - Python 3.11+
 - npm
 
 ## 🔧 Installation
 
-Install agentspy directly from GitHub:
+Install agentwatch directly from GitHub:
 
 ```bash
-pip install git+https://github.com/cyberark/agentspy.git
+pip install git+https://github.com/cyberark/agentwatch.git
 ```
 
 ## 🖥️ Quick Start
 
-1. Import agentspy in your main module:
+1. Import agentwatch in your main module:
    ```python
-   import agentspy
+   import agentwatch
    ```
 
 2. Ensure your entry point is within a `__main__` block:
@@ -71,14 +71,14 @@ pip install git+https://github.com/cyberark/agentspy.git
 
 3. Launch the UI:
    ```bash
-   agentspy ui
+   agentwatch ui
    # (Take note this will open a new tab in your browser)
    ```
 
 Run your main module - and AI agent interactions will now be automatically tracked and monitored in the UI!
 
 ## 📌 Examples
-We've included a few examples under the [examples/](https://github.com/cyberark/agentspy/tree/main/examples) folder.
+We've included a few examples under the [examples/](https://github.com/cyberark/agentwatch/tree/main/examples) folder.
 To use the examples, clone this repository, and follow these steps:
 
 1. Install python dependencies using poetry. If you don't have Poetry installed, get it [here](https://python-poetry.org/)
@@ -98,15 +98,15 @@ To use the examples, clone this repository, and follow these steps:
 
 ## 📚 Documentation
 
-For comprehensive guides and detailed usage instructions, visit our [GitHub Wiki](https://github.com/cyberark/agentspy/wiki).
+For comprehensive guides and detailed usage instructions, visit our [GitHub Wiki](https://github.com/cyberark/agentwatch/wiki).
 
 ## 🤝 Contributing
 
-We welcome contributions! Please review our [CONTRIBUTING.md](https://github.com/cyberark/agentspy/blob/main/CONTRIBUTING.md) for guidelines on how to get involved.
+We welcome contributions! Please review our [CONTRIBUTING.md](https://github.com/cyberark/agentwatch/blob/main/CONTRIBUTING.md) for guidelines on how to get involved.
 
 ## 📄 License
 
-agentspy is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
+agentwatch is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
 
 ## 📧 Contact
 

examples/autogen_example.py

@@ -6,7 +6,7 @@
 import autogen
 from dotenv import load_dotenv
 
-from agentspy.core import initialize
+from agentwatch.core import initialize
 
 logging.basicConfig(level=logging.DEBUG)
 

examples/crewi_example.py

@@ -7,7 +7,7 @@
 from crewai import LLM, Agent, Crew, Process, Task
 from crewai.tools import tool
 
-import agentspy
+import agentwatch
 
 logger = logging.getLogger(__name__)
 

examples/langgraph_example.py

@@ -9,7 +9,7 @@
 from langchain_openai import ChatOpenAI
 from langgraph.prebuilt import create_react_agent
 
-import agentspy
+import agentwatch
 
 logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
 

examples/weather_example.py

@@ -8,8 +8,8 @@
 from langchain_openai import ChatOpenAI
 from langgraph.prebuilt import create_react_agent
 
-# Uncomment this to use agentspy
-#import agentspy
+# Uncomment this to use agentwatch
+#import agentwatch
 
 logging.basicConfig(level=logging.ERROR, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
 load_dotenv()

pyproject.toml

@@ -1,8 +1,8 @@
 [tool.setuptools]
-py-modules = ["agentspy"]
+py-modules = ["agentwatch"]
 
 [tool.poetry]
-name = "agentspy"
+name = "agentwatch"
 version = "1.0.0"
 description = "Platform agnostic Agentic AI runtime observability framework"
 authors = ["Shai Dvash <[email protected]>"]
@@ -39,7 +39,7 @@ pythonpath = [
 ]
 
 [tool.poetry.scripts]
-agentspy = "agentspy.cli:main"
+agentwatch = "agentwatch.cli:main"
 
 [build-system]
 requires = ["setuptools>=40.9.0", "wheel", "poetry-core>=1.0.0"]

resources/agentspy.gif resources/agentwatch.gif

@@ -1,2 +1,2 @@
 #!/bin/bash
-poetry run python src/agentspy/cli.py ui
+poetry run python src/agentwatch/cli.py ui

run_ui.sh

@@ -2,18 +2,18 @@
 import sys
 from multiprocessing import current_process
 
-from agentspy.consts import AGENTSPY_INTERNAL
-from agentspy.core import initialize
+from agentwatch.consts import AGENTWATCH_INTERNAL
+from agentwatch.core import initialize
 
 
 def _is_direct_execution() -> bool:
-    return sys.argv[0].endswith("agentspy")
+    return sys.argv[0].endswith("agentwatch")
 
 def _safe_to_start() -> bool:
     # Only run on original script execution, not in subprocess or interpreter bootstrapping
     return current_process().name == "MainProcess" \
         and not hasattr(sys, '_called_from_spawn') \
-        and os.environ.get(AGENTSPY_INTERNAL) is None \
+        and os.environ.get(AGENTWATCH_INTERNAL) is None \
         and "PYTEST_VERSION" not in os.environ \
         and not _is_direct_execution()
 

src/agentspy/consts.py

@@ -2,10 +2,10 @@
 import sys
 from pathlib import Path
 
-from agentspy.consts import AGENTSPY_INTERNAL
+from agentwatch.consts import AGENTWATCH_INTERNAL
 
 sys.path.insert(0, str(Path(__file__).parent.parent))
-os.environ[AGENTSPY_INTERNAL] = "1"
+os.environ[AGENTWATCH_INTERNAL] = "1"
 
 import argparse
 import asyncio
@@ -15,14 +15,14 @@
 from pathlib import Path
 from typing import Any
 
-from agentspy.visualization.app import run_fastapi
-from agentspy.visualization.consts import VISUALIZATION_SERVER_PORT
+from agentwatch.visualization.app import run_fastapi
+from agentwatch.visualization.consts import VISUALIZATION_SERVER_PORT
 
 logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
 
 async def run_server() -> None:
     try:
-        tasks = [run_fastapi("agentspy.visualization.server:app")]
+        tasks = [run_fastapi("agentwatch.visualization.server:app")]
         await asyncio.sleep(1.0)
         webbrowser.open_new_tab(f"http://localhost:{VISUALIZATION_SERVER_PORT}/ui")
         await asyncio.gather(*tasks)
@@ -54,11 +54,11 @@ def run_ui() -> None:
         pass
 
 def main() -> None:
-    parser = argparse.ArgumentParser(prog="agentspy", description="agentspy - a platform agnostic agentic ai observability framework")
+    parser = argparse.ArgumentParser(prog="agentwatch", description="agentwatch - a platform agnostic agentic ai observability framework")
     subparsers = parser.add_subparsers(dest="command", required=True)
 
     # UI Command
-    ui_parser = subparsers.add_parser("ui", help="Launch (and build, if necessary) the agentspy")
+    ui_parser = subparsers.add_parser("ui", help="Launch (and build, if necessary) the agentwatch")
     ui_parser.set_defaults(func=run_ui)
 
     args = parser.parse_args()

src/agentspy/core.py

@@ -8,26 +8,26 @@
 import uuid
 from typing import Any, Optional, Type
 
-from agentspy.enums import CommandAction
-from agentspy.event_processor import EventProcessor
-from agentspy.hooks.base import BaseHook, HookCallbackProto
-from agentspy.hooks.http.http_base_hook import HttpInterceptHook
-from agentspy.hooks.http.httpcore_hook import HttpcoreHook
-from agentspy.hooks.models import HookEvent
-from agentspy.models import Command, CommandResponse
-from agentspy.pipes import Pipes
+from agentwatch.enums import CommandAction
+from agentwatch.event_processor import EventProcessor
+from agentwatch.hooks.base import BaseHook, HookCallbackProto
+from agentwatch.hooks.http.http_base_hook import HttpInterceptHook
+from agentwatch.hooks.http.httpcore_hook import HttpcoreHook
+from agentwatch.hooks.models import HookEvent
+from agentwatch.models import Command, CommandResponse
+from agentwatch.pipes import Pipes
 
 logger = logging.getLogger(__name__)
-class AgentspyClient(HookCallbackProto):
+class AgentwatchClient(HookCallbackProto):
     def __init__(self) -> None:
         self._process: Optional[multiprocessing.Process] = None
         self._running = False
 
         self._exit_ready_event = multiprocessing.Event()
         self._initialized_event = multiprocessing.Event()
 
-        self._client_fd, self._agentspy_fd = multiprocessing.Pipe()
-        self._agentspy = EventProcessor()
+        self._client_fd, self._agentwatch_fd = multiprocessing.Pipe()
+        self._agentwatch = EventProcessor()
 
         self._llm_hosts =[
             "api.openai.com",
@@ -47,7 +47,7 @@ def __init__(self) -> None:
         atexit.register(self._cleanup)
 
         self._execution_id = uuid.uuid4().hex
-        self._start_agentspy()
+        self._start_agentwatch()
 
     def set_verbose(self) -> None:
         logger.setLevel(logging.DEBUG)
@@ -116,15 +116,15 @@ def send_command_wait(self, action: CommandAction, params: Optional[dict[str, An
             except TimeoutError:
                 raise TimeoutError(f"Timeout waiting for response to {action}")
 
-    def _start_agentspy(self) -> None:
+    def _start_agentwatch(self) -> None:
         """Initialize the library by starting the process"""
         if self._running:
             logger.warning("Library is already initialized")
             return
 
         logger.debug("Initializing library process")
         self._process = multiprocessing.Process(
-            target=self._agentspy.start,
+            target=self._agentwatch.start,
             args=(self._client_fd, self._initialized_event, self._exit_ready_event),
             daemon=True
         )
@@ -154,23 +154,23 @@ def _cleanup(self) -> None:
     def _write_command(self, command: Command) -> None:
         """Write a command to the command pipe"""
         try:
-            logger.debug(f"Sending command: {command.action}:{command.callback_id} to fd {self._agentspy_fd.fileno()}")
-            Pipes.write_payload_sync(self._agentspy_fd, command)
+            logger.debug(f"Sending command: {command.action}:{command.callback_id} to fd {self._agentwatch_fd.fileno()}")
+            Pipes.write_payload_sync(self._agentwatch_fd, command)
         except Exception as e:
             logger.error(f"Error writing command: {e}")
             raise
 
     def _read_response(self, timeout: float = 5.0) -> Optional[CommandResponse]:
         """Read a response from the response pipe with timeout"""
-        return Pipes.read_response(self._agentspy_fd, timeout)
+        return Pipes.read_response(self._agentwatch_fd, timeout)
 
     def shutdown(self) -> None:
         """Shut down the library process"""
         if not self._running:
             logger.warning("Library is not running")
             return
 
-        logger.debug("Shutting down agentspy")
+        logger.debug("Shutting down agentwatch")
         try:
             # Send shutdown command
             self.send_command(CommandAction.SHUTDOWN)
@@ -183,7 +183,7 @@ def shutdown(self) -> None:
 
             # Force terminate if still running
             if self._process and self._process.is_alive():
-                logger.warning("agentspy didn't shut down gracefully, terminating")
+                logger.warning("agentwatch didn't shut down gracefully, terminating")
                 self._process.terminate()
 
                 # Wait for process to terminate

src/agentspy/__init__.py src/agentwatch/__init__.py

@@ -0,0 +1,3 @@
+from typing import Final
+
+AGENTWATCH_INTERNAL: Final[str] = "AGENTWATCH_INTERNAL"