flamepy 0.3.0__tar.gz → 0.5.0__tar.gz

{flamepy-0.3.0/src/flamepy.egg-info → flamepy-0.5.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: flamepy
-Version: 0.3.0
-Summary: Python SDK for Flame distributed engine
+Version: 0.5.0
+Summary: Python SDK for Flame, a distributed system for Agentic AI
 Author-email: XFLOPS Authors <support@xflops.io>
 Project-URL: Homepage, https://xflops.io
 Project-URL: Repository, https://github.com/xflops/flame
 Project-URL: Issues, https://github.com/xflops/flame/issues
-Keywords: distributed computing,flame,sdk
+Keywords: distributed system,agentic ai,flame,sdk
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
@@ -15,12 +15,16 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
-Requires-Python: >=3.8
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: grpcio>=1.50.0
 Requires-Dist: grpcio-tools>=1.50.0
 Requires-Dist: protobuf>=4.21.0
+Requires-Dist: pydantic>=2.11.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn>=0.35.0
+Requires-Dist: pyyaml>=6.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
@@ -31,7 +35,7 @@ Dynamic: license-file
 
 # Flame Python SDK
 
-Python SDK for the Flame distributed computing framework.
+Python SDK for the Flame, a distributed system for Agentic AI.
 
 ## Installation
 
@@ -43,30 +47,20 @@ pip install flamepy
 
 ```python
 import asyncio
-from flamepy import SessionAttributes, connect
+import flamepy
 
 async def main():
-    # Connect to Flame service
-    conn = await connect("http://localhost:8080")
-    # Create a session
-    session = await conn.create_session(SessionAttributes(
-        application="flmlog",
-        slots=2,
-        common_data=b"shared data"
-    ))
+    # Create a session with the application, e.g. Agent
+    session = await flamepy.create_session("flmping")
     
     # Create and run a task
-    task = await session.create_task(b"task input data")
-    
-    # Watch task progress
-    async for update in session.watch_task(task.id):
-        print(f"Task {task.id}: {update.state}")
-        if update.is_completed():
-            break
-    
+    resp = await session.invoke(b"task input data")
+
+    # Handle the output of task
+    print(resp.output)
+
     # Close session
     await session.close()
-    await conn.close()
 
 if __name__ == "__main__":
     asyncio.run(main())
@@ -74,30 +68,13 @@ if __name__ == "__main__":
 
 ## API Reference
 
-### Connection
-
-The main entry point for connecting to Flame services.
-
-```python
-from flamepy import connect
-
-# Connect to a Flame service
-conn = await connect("http://localhost:8080")
-```
-
 ### Session
 
-Represents a computing session with distributed resources.
+Represents a computing session with application, e.g. Agent, Tools.
 
 ```python
 # Create a session
-session = await conn.create_session(SessionAttributes(
-    application="my-app",
-    slots=2
-))
-
-# List sessions
-sessions = await conn.list_sessions()
+session = await flamepy.create_session("my-app")
 
 # Close a session
 await session.close()
@@ -109,7 +86,7 @@ Represents individual computing tasks within a session.
 
 ```python
 # Create a task
-task = await session.create_task(b"input data")
+task = await session.invoke(b"input data")
 
 # Get task status
 task = await session.get_task(task.id)
@@ -121,22 +98,6 @@ async for update in session.watch_task(task.id):
         break
 ```
 
-### Application
-
-Manage distributed applications.
-
-```python
-# Register an application
-await conn.register_application("my-app", {
-    "shim": Shim.SHELL,
-    "command": "python",
-    "arguments": ["script.py"]
-})
-
-# List applications
-apps = await conn.list_applications()
-```
-
 ## Error Handling
 
 The SDK provides custom exception types for different error scenarios:
@@ -145,7 +106,7 @@ The SDK provides custom exception types for different error scenarios:
 from flamepy import FlameError, FlameErrorCode
 
 try:
-    session = await conn.create_session(attrs)
+    session = await flamepy.create_session("flmping")
 except FlameError as e:
     if e.code == FlameErrorCode.INVALID_CONFIG:
         print("Configuration error:", e.message)
@@ -159,7 +120,7 @@ To set up the development environment:
 
 ```bash
 # Clone the repository
-git clone https://github.com/flame-sh/flame.git
+git clone https://github.com/xflops/flame.git
 cd flame/sdk/python
 
 # Install in development mode

flamepy-0.5.0/README.md

@@ -0,0 +1,103 @@
+# Flame Python SDK
+
+Python SDK for the Flame, a distributed system for Agentic AI.
+
+## Installation
+
+```bash
+pip install flamepy
+```
+
+## Quick Start
+
+```python
+import asyncio
+import flamepy
+
+async def main():
+    # Create a session with the application, e.g. Agent
+    session = await flamepy.create_session("flmping")
+    
+    # Create and run a task
+    resp = await session.invoke(b"task input data")
+
+    # Handle the output of task
+    print(resp.output)
+
+    # Close session
+    await session.close()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## API Reference
+
+### Session
+
+Represents a computing session with application, e.g. Agent, Tools.
+
+```python
+# Create a session
+session = await flamepy.create_session("my-app")
+
+# Close a session
+await session.close()
+```
+
+### Task
+
+Represents individual computing tasks within a session.
+
+```python
+# Create a task
+task = await session.invoke(b"input data")
+
+# Get task status
+task = await session.get_task(task.id)
+
+# Watch task progress
+async for update in session.watch_task(task.id):
+    print(f"Task state: {update.state}")
+    if update.is_completed():
+        break
+```
+
+## Error Handling
+
+The SDK provides custom exception types for different error scenarios:
+
+```python
+from flamepy import FlameError, FlameErrorCode
+
+try:
+    session = await flamepy.create_session("flmping")
+except FlameError as e:
+    if e.code == FlameErrorCode.INVALID_CONFIG:
+        print("Configuration error:", e.message)
+    elif e.code == FlameErrorCode.INVALID_STATE:
+        print("State error:", e.message)
+```
+
+## Development
+
+To set up the development environment:
+
+```bash
+# Clone the repository
+git clone https://github.com/xflops/flame.git
+cd flame/sdk/python
+
+# Install in development mode
+pip install -e .[dev]
+
+# Run tests
+pytest
+
+# Format code
+black flamepy/
+isort flamepy/
+
+# Type checking
+mypy flamepy/
+``` 

{flamepy-0.3.0 → flamepy-0.5.0}/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flamepy"
-version = "0.3.0"
-description = "Python SDK for Flame distributed engine"
+version = "0.5.0"
+description = "Python SDK for Flame, a distributed system for Agentic AI"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.12"
 license-files = ["LICENSE"]
 authors = [
   {name = "XFLOPS Authors", email = "support@xflops.io"}
 ]
-keywords = ["distributed computing", "flame", "sdk"]
+keywords = ["distributed system", "agentic ai", "flame", "sdk"]
 classifiers = [
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
@@ -27,6 +27,10 @@ dependencies = [
   "grpcio>=1.50.0",
   "grpcio-tools>=1.50.0",
   "protobuf>=4.21.0",
+  "pydantic>=2.11.0",
+  "fastapi>=0.115.0",
+  "uvicorn>=0.35.0",
+  "pyyaml>=6.0.0",
 ]
 
 [project.optional-dependencies]

flamepy-0.5.0/src/flamepy/__init__.py

@@ -0,0 +1,131 @@
+
+
+"""
+Copyright 2025 The Flame Authors.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+    http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import logging
+import os
+
+_log_level_str = os.getenv("FLAME_LOG_LEVEL", "INFO").upper()
+_log_level_map = {
+    "CRITICAL": logging.CRITICAL,
+    "ERROR": logging.ERROR,
+    "WARNING": logging.WARNING,
+    "INFO": logging.INFO,
+    "DEBUG": logging.DEBUG,
+}
+
+_log_level = _log_level_map[_log_level_str] if _log_level_str in _log_level_map else logging.INFO
+
+logging.basicConfig(level=_log_level)
+
+from .types import (
+    # Type aliases
+    TaskID,
+    SessionID,
+    ApplicationID,
+    Message,
+    TaskInput,
+    TaskOutput,
+    CommonData,
+    
+    # Enums
+    SessionState,
+    TaskState,
+    ApplicationState,
+    Shim,
+
+    FlameErrorCode,
+    
+    # Classes
+    FlameError,
+    SessionAttributes,
+    ApplicationAttributes,
+    Task,
+    Application,
+    FlameContext,
+    TaskInformer,
+    Request,
+    Response,
+)
+
+from .client import (Connection, Session, TaskWatcher, 
+    connect, create_session, register_application, unregister_application, list_applications, get_application, 
+    list_sessions, get_session, close_session
+)
+from .service import (
+    FlameService,
+    ApplicationContext, SessionContext, TaskContext, TaskOutput,
+    run
+)
+from .instance import FlameInstance
+
+__version__ = "0.3.0"
+
+__all__ = [
+    # Type aliases
+    "TaskID",
+    "SessionID", 
+    "ApplicationID",
+    "Message",
+    "TaskInput",
+    "TaskOutput",
+    "CommonData",
+    
+    # Enums
+    "SessionState",
+    "TaskState", 
+    "ApplicationState",
+    "Shim",
+    "FlameErrorCode",
+
+    # Service classes
+    "FlameService",
+    "ApplicationContext",
+    "SessionContext",
+    "TaskContext",
+    "TaskOutput",
+    "run",
+
+    # Classes
+    "FlameError",
+    "SessionAttributes",
+    "ApplicationAttributes", 
+    "Task",
+    "Application",
+    "FlameContext",
+    "TaskInformer",
+    "Request",
+    "Response",
+    
+    # Client classes
+    "Connection",
+    "connect",
+    "create_session",
+    "register_application",
+    "unregister_application",
+    "list_applications",
+    "get_application",
+    "list_sessions",
+    "get_session",
+    "close_session",
+    "TaskWatcher",
+    "Session", 
+    "Task",
+    "TaskInput",
+    "TaskOutput",
+    "CommonData",
+
+    # Instance classes
+    "FlameInstance",
+]