Merge branch 'exospherehost:main' into main

Author: bhaveshAswani112

api-server/uv.lock

@@ -16,10 +16,10 @@
     "@tailwindcss/typography": "^0.5.16",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "framer-motion": "^12.23.11",
+    "framer-motion": "^12.23.12",
     "gray-matter": "^4.0.3",
     "lucide-react": "^0.534.0",
-    "motion": "^12.23.11",
+    "motion": "^12.23.12",
     "next": "15.4.5",
     "next-themes": "^0.4.6",
     "react": "^19.0.0",

landing-page/package-lock.json

@@ -1,2 +1,24 @@
 # ExosphereHost Python SDK
-This SDK is official python SDK for ExosphereHost and interacting with exospherehost.
+This is the official Python SDK for ExosphereHost and for interacting with ExosphereHost.
+
+## Node Creation
+You can simply connect to exosphere state manager and start creating your nodes, as shown in sample below: 
+
+```python
+from exospherehost import Runtime, BaseNode
+from typing import Any
+import os
+
+class SampleNode(BaseNode):
+    async def execute(self, inputs: dict[str, Any]) -> dict[str, Any]:
+        print(inputs)
+        return {"message": "success"}
+
+runtime = Runtime("SampleNamespace", os.getenv("EXOSPHERE_STATE_MANAGER_URI", "http://localhost:8000"), os.getenv("EXOSPHERE_API_KEY", ""))
+
+runtime.connect([SampleNode()])
+runtime.start()
+```
+
+## Support
+For first-party support and questions, do not hesitate to reach out to us at <nivedit@exosphere.host>.

landing-page/package.json

@@ -1,6 +1,7 @@
-from ._version import VERSION
+from ._version import version as __version__
+from .runtime import Runtime
+from .node.BaseNode import BaseNode
 
-__version__ = VERSION
+VERSION = __version__
 
-def test():
-    print(f"ExosphereHost PySDK v{VERSION}")
+__all__ = ["Runtime", "BaseNode", "VERSION"]

python-sdk/README.md

@@ -1 +1 @@
-VERSION = "0.0.3b"
+version = "0.0.4b"

python-sdk/exospherehost/__init__.py

@@ -1,5 +1,5 @@
 from abc import ABC, abstractmethod
-from typing import Optional
+from typing import Optional, Any
 
 
 class BaseNode(ABC):
@@ -8,7 +8,7 @@ def __init__(self, unique_name: Optional[str] = None):
         self.unique_name: Optional[str] = unique_name
 
     @abstractmethod
-    async def execute(self):
+    async def execute(self, inputs: dict[str, Any]) -> dict[str, Any]:
         pass
 
     def get_unique_name(self) -> str:

python-sdk/exospherehost/_version.py

@@ -1 +0,0 @@
-from .BaseNode import BaseNode