cycls 0.0.2.82__tar.gz → 0.0.2.84__tar.gz

{cycls-0.0.2.82 → cycls-0.0.2.84}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.82
+Version: 0.0.2.84
 Summary: Distribute Intelligence
 Author: Mohammed J. AlRujayi
 Author-email: mj@cycls.com
@@ -12,14 +12,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Provides-Extra: modal
 Requires-Dist: cloudpickle (>=3.1.1,<4.0.0)
 Requires-Dist: docker (>=7.1.0,<8.0.0)
 Requires-Dist: fastapi (>=0.111.0,<0.112.0)
-Requires-Dist: grpcio (>=1.76.0,<2.0.0)
 Requires-Dist: httpx (>=0.27.0,<0.28.0)
-Requires-Dist: modal (>=1.1.0,<2.0.0) ; extra == "modal"
-Requires-Dist: protobuf (>=6.0,<7.0)
 Requires-Dist: pyjwt (>=2.8.0,<3.0.0)
 Description-Content-Type: text/markdown
 
@@ -49,6 +45,8 @@ The open-source SDK for distributing AI agents.
 
 The function is the unit of abstraction in cycls. Your agent logic lives in a plain Python function — the decorator layers on everything else: containerization, authentication, deployment, analytics. You write the function, the `@` handles the infrastructure.
 
+Cycls is beautifully lean (~862 lines!) and focused on deployment infrastructure for any Python function, not agent logic itself.
+
 ## Distribute Intelligence
 
 Write a function. Deploy it as an API, a web interface, or both. Add authentication, analytics, and monetization with flags.
@@ -58,8 +56,8 @@ import cycls
 
 cycls.api_key = "YOUR_CYCLS_API_KEY"
 
-@cycls.agent(pip=["openai"])
-async def agent(context):
+@cycls.app(pip=["openai"])
+async def app(context):
     from openai import AsyncOpenAI
     client = AsyncOpenAI()
 
@@ -76,7 +74,7 @@ async def agent(context):
         elif event.type == "response.output_text.delta":
             yield event.delta
 
-agent.deploy()  # Live at https://agent.cycls.ai
+app.deploy()  # Live at https://agent.cycls.ai
 ```
 
 ## Installation
@@ -99,9 +97,9 @@ Requires Docker.
 ## Running
 
 ```python
-agent.local()             # Development with hot-reload (localhost:8080)
-agent.local(watch=False)  # Development without hot-reload
-agent.deploy()            # Production: https://agent.cycls.ai
+app.local()             # Development with hot-reload (localhost:8080)
+app.local(watch=False)  # Development without hot-reload
+app.deploy()            # Production: https://agent.cycls.ai
 ```
 
 Get an API key at [cycls.com](https://cycls.com).
@@ -109,8 +107,8 @@ Get an API key at [cycls.com](https://cycls.com).
 ## Authentication & Analytics
 
 ```python
-@cycls.agent(pip=["openai"], auth=True, analytics=True)
-async def agent(context):
+@cycls.app(pip=["openai"], auth=True, analytics=True)
+async def app(context):
     # context.user available when auth=True
     user = context.user  # User(id, email, name, plans)
     yield f"Hello {user.name}!"
@@ -127,7 +125,7 @@ async def agent(context):
 Yield structured objects for rich streaming responses:
 
 ```python
-@cycls.agent()
+@cycls.app()
 async def demo(context):
     yield {"type": "thinking", "thinking": "Analyzing the request..."}
     yield "Here's what I found:\n\n"
@@ -169,7 +167,7 @@ This works seamlessly with OpenAI's reasoning models - just map reasoning summar
 ## Context Object
 
 ```python
-@cycls.agent()
+@cycls.app()
 async def chat(context):
     context.messages      # [{"role": "user", "content": "..."}]
     context.messages.raw  # Full data including UI component parts
@@ -202,13 +200,13 @@ See [docs/streaming-protocol.md](docs/streaming-protocol.md) for frontend integr
 Define your entire runtime in the decorator:
 
 ```python
-@cycls.agent(
+@cycls.app(
     pip=["openai", "pandas", "numpy"],
     apt=["ffmpeg", "libmagic1"],
     copy=["./utils.py", "./models/", "/absolute/path/to/config.json"],
     copy_public=["./assets/logo.png", "./static/"],
 )
-async def my_agent(context):
+async def my_app(context):
     ...
 ```
 
@@ -243,7 +241,7 @@ copy=[
 Then import them in your function:
 
 ```python
-@cycls.agent(copy=["./utils.py"])
+@cycls.app(copy=["./utils.py"])
 async def chat(context):
     from utils import helper_function  # Your bundled module
     ...
@@ -257,7 +255,7 @@ Files and directories served at the `/public` endpoint. Perfect for images, down
 copy_public=["./assets/logo.png", "./downloads/"]
 ```
 
-Access them at `https://your-agent.cycls.ai/public/logo.png`.
+Access them at `https://your-app.cycls.ai/public/logo.png`.
 
 ---
 

{cycls-0.0.2.82 → cycls-0.0.2.84}/README.md

@@ -24,6 +24,8 @@ The open-source SDK for distributing AI agents.
 
 The function is the unit of abstraction in cycls. Your agent logic lives in a plain Python function — the decorator layers on everything else: containerization, authentication, deployment, analytics. You write the function, the `@` handles the infrastructure.
 
+Cycls is beautifully lean (~862 lines!) and focused on deployment infrastructure for any Python function, not agent logic itself.
+
 ## Distribute Intelligence
 
 Write a function. Deploy it as an API, a web interface, or both. Add authentication, analytics, and monetization with flags.
@@ -33,8 +35,8 @@ import cycls
 
 cycls.api_key = "YOUR_CYCLS_API_KEY"
 
-@cycls.agent(pip=["openai"])
-async def agent(context):
+@cycls.app(pip=["openai"])
+async def app(context):
     from openai import AsyncOpenAI
     client = AsyncOpenAI()
 
@@ -51,7 +53,7 @@ async def agent(context):
         elif event.type == "response.output_text.delta":
             yield event.delta
 
-agent.deploy()  # Live at https://agent.cycls.ai
+app.deploy()  # Live at https://agent.cycls.ai
 ```
 
 ## Installation
@@ -74,9 +76,9 @@ Requires Docker.
 ## Running
 
 ```python
-agent.local()             # Development with hot-reload (localhost:8080)
-agent.local(watch=False)  # Development without hot-reload
-agent.deploy()            # Production: https://agent.cycls.ai
+app.local()             # Development with hot-reload (localhost:8080)
+app.local(watch=False)  # Development without hot-reload
+app.deploy()            # Production: https://agent.cycls.ai
 ```
 
 Get an API key at [cycls.com](https://cycls.com).
@@ -84,8 +86,8 @@ Get an API key at [cycls.com](https://cycls.com).
 ## Authentication & Analytics
 
 ```python
-@cycls.agent(pip=["openai"], auth=True, analytics=True)
-async def agent(context):
+@cycls.app(pip=["openai"], auth=True, analytics=True)
+async def app(context):
     # context.user available when auth=True
     user = context.user  # User(id, email, name, plans)
     yield f"Hello {user.name}!"
@@ -102,7 +104,7 @@ async def agent(context):
 Yield structured objects for rich streaming responses:
 
 ```python
-@cycls.agent()
+@cycls.app()
 async def demo(context):
     yield {"type": "thinking", "thinking": "Analyzing the request..."}
     yield "Here's what I found:\n\n"
@@ -144,7 +146,7 @@ This works seamlessly with OpenAI's reasoning models - just map reasoning summar
 ## Context Object
 
 ```python
-@cycls.agent()
+@cycls.app()
 async def chat(context):
     context.messages      # [{"role": "user", "content": "..."}]
     context.messages.raw  # Full data including UI component parts
@@ -177,13 +179,13 @@ See [docs/streaming-protocol.md](docs/streaming-protocol.md) for frontend integr
 Define your entire runtime in the decorator:
 
 ```python
-@cycls.agent(
+@cycls.app(
     pip=["openai", "pandas", "numpy"],
     apt=["ffmpeg", "libmagic1"],
     copy=["./utils.py", "./models/", "/absolute/path/to/config.json"],
     copy_public=["./assets/logo.png", "./static/"],
 )
-async def my_agent(context):
+async def my_app(context):
     ...
 ```
 
@@ -218,7 +220,7 @@ copy=[
 Then import them in your function:
 
 ```python
-@cycls.agent(copy=["./utils.py"])
+@cycls.app(copy=["./utils.py"])
 async def chat(context):
     from utils import helper_function  # Your bundled module
     ...
@@ -232,7 +234,7 @@ Files and directories served at the `/public` endpoint. Perfect for images, down
 copy_public=["./assets/logo.png", "./downloads/"]
 ```
 
-Access them at `https://your-agent.cycls.ai/public/logo.png`.
+Access them at `https://your-app.cycls.ai/public/logo.png`.
 
 ---
 

cycls-0.0.2.84/cycls/__init__.py

@@ -0,0 +1,14 @@
+from . import function as _function_module
+from .function import function, Function
+from .app import app, App
+
+def __getattr__(name):
+    if name in ("api_key", "base_url"):
+        return getattr(_function_module, name)
+    raise AttributeError(f"module 'cycls' has no attribute '{name}'")
+
+def __setattr__(name, value):
+    if name in ("api_key", "base_url"):
+        setattr(_function_module, name, value)
+    else:
+        raise AttributeError(f"module 'cycls' has no attribute '{name}'")

cycls-0.0.2.84/cycls/app.py

@@ -0,0 +1,88 @@
+import os
+import uvicorn
+import importlib.resources
+
+from .function import Function, _get_api_key, _get_base_url
+from .web import web, Config
+
+CYCLS_PATH = importlib.resources.files('cycls')
+
+THEMES = ["default", "dev"]
+
+
+class App(Function):
+    """App extends Function with web UI serving capabilities."""
+
+    def __init__(self, func, name, theme="default", pip=None, apt=None, copy=None, copy_public=None,
+                 auth=False, org=None, header=None, intro=None, title=None, plan="free", analytics=False):
+        if theme not in THEMES:
+            raise ValueError(f"Unknown theme: {theme}. Available: {THEMES}")
+        self.user_func = func
+        self.theme = theme
+        self.copy_public = copy_public or []
+
+        self.config = Config(
+            header=header,
+            intro=intro,
+            title=title,
+            auth=auth,
+            plan=plan,
+            analytics=analytics,
+            org=org,
+        )
+
+        # Build files dict for Function (theme is inside cycls/)
+        files = {str(CYCLS_PATH): "cycls"}
+        files.update({f: f for f in copy or []})
+        files.update({f: f"public/{f}" for f in self.copy_public})
+
+        super().__init__(
+            func=func,
+            name=name,
+            pip=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", "docker", *(pip or [])],
+            apt=apt,
+            copy=files,
+            base_url=_get_base_url(),
+            api_key=_get_api_key()
+        )
+
+    def __call__(self, *args, **kwargs):
+        return self.user_func(*args, **kwargs)
+
+    def _prepare_func(self, prod):
+        self.config.set_prod(prod)
+        self.config.public_path = f"cycls/themes/{self.theme}"
+        user_func, config, name = self.user_func, self.config, self.name
+        self.func = lambda port: __import__("cycls").web.serve(user_func, config, name, port)
+
+    def _local(self, port=8080):
+        """Run directly with uvicorn (no Docker)."""
+        print(f"Starting local server at localhost:{port}")
+        self.config.public_path = str(CYCLS_PATH.joinpath(f"themes/{self.theme}"))
+        self.config.set_prod(False)
+        uvicorn.run(web(self.user_func, self.config), host="0.0.0.0", port=port)
+
+    def local(self, port=8080, watch=True):
+        """Run locally in Docker with file watching by default."""
+        if os.environ.get('_CYCLS_WATCH'):
+            watch = False
+        self._prepare_func(prod=False)
+        self.watch(port=port) if watch else self.run(port=port)
+
+    def deploy(self, port=8080):
+        """Deploy to production."""
+        if self.api_key is None:
+            raise RuntimeError("Missing API key. Set cycls.api_key or CYCLS_API_KEY environment variable.")
+        self._prepare_func(prod=True)
+        return super().deploy(port=port)
+
+
+def app(name=None, **kwargs):
+    """Decorator that transforms a function into a deployable App."""
+    if kwargs.get("plan") == "cycls_pass":
+        kwargs["auth"] = True
+        kwargs["analytics"] = True
+
+    def decorator(func):
+        return App(func=func, name=name or func.__name__, **kwargs)
+    return decorator