cycls 0.0.2.71__py3-none-any.whl → 0.0.2.73__py3-none-any.whl

cycls/__init__.py

@@ -1,2 +1,15 @@
-from .sdk import Agent, function
-from .runtime import Runtime
+from .sdk import function, agent
+from .runtime import Runtime
+
+def __getattr__(name):
+    from . import sdk
+    if name in ("api_key", "base_url"):
+        return getattr(sdk, name)
+    raise AttributeError(f"module 'cycls' has no attribute '{name}'")
+
+def __setattr__(name, value):
+    from . import sdk
+    if name in ("api_key", "base_url"):
+        setattr(sdk, name, value)
+        return
+    raise AttributeError(f"module 'cycls' has no attribute '{name}'")

cycls/runtime.py

@@ -178,9 +178,11 @@ class Runtime:
 
     def _generate_dockerfile(self, port=None) -> str:
         """Generates a multi-stage Dockerfile string."""
-        # Only install extra packages not in base image
+        using_base = self.base_image == BASE_IMAGE
+
+        # Only install extra packages not in base image (use uv if available in base)
         run_pip_install = (
-            f"RUN pip install --no-cache-dir {' '.join(self.pip_packages)}"
+            f"RUN uv pip install --system --no-cache {' '.join(self.pip_packages)}"
             if self.pip_packages else ""
         )
         run_apt_install = (
@@ -191,16 +193,19 @@ class Runtime:
         copy_lines = "\n".join([f"COPY context_files/{dst} {dst}" for dst in self.copy.values()])
         expose_line = f"EXPOSE {port}" if port else ""
 
+        # Skip env/mkdir/workdir if using pre-built base (already configured)
+        env_lines = "" if using_base else f"""ENV PIP_ROOT_USER_ACTION=ignore \\
+    PYTHONUNBUFFERED=1
+RUN mkdir -p {self.io_dir}
+WORKDIR /app"""
+
         return f"""
 # STAGE 1: Base image with all dependencies
 FROM {self.base_image} as base
-ENV PIP_ROOT_USER_ACTION=ignore
-ENV PYTHONUNBUFFERED=1
-RUN mkdir -p {self.io_dir}
+{env_lines}
 {run_apt_install}
 {run_pip_install}
 {run_shell_commands}
-WORKDIR /app
 {copy_lines}
 COPY {self.runner_filename} {self.runner_path}
 ENTRYPOINT ["python", "{self.runner_path}", "{self.io_dir}"]

cycls/sdk.py

@@ -1,30 +1,21 @@
-import os, time, inspect, uvicorn
+import os, time, uvicorn
 from .runtime import Runtime
 from .web import web, Config
 from .auth import PK_LIVE, PK_TEST, JWKS_PROD, JWKS_TEST
 import importlib.resources
-from pydantic import BaseModel
-from typing import Callable
 
 CYCLS_PATH = importlib.resources.files('cycls')
 
-class RegisteredAgent(BaseModel):
-    func: Callable
-    name: str
-    domain: str
-    config: Config
-
-def set_prod(config: Config, prod: bool):
-    config.prod = prod
-    config.pk = PK_LIVE if prod else PK_TEST
-    config.jwks = JWKS_PROD if prod else JWKS_TEST
+# Module-level configuration
+api_key = None
+base_url = None
 
 themes = {
     "default": CYCLS_PATH.joinpath('default-theme'),
     "dev": CYCLS_PATH.joinpath('dev-theme'),
 }
 
-def resolve_theme(theme):
+def _resolve_theme(theme):
     """Resolve theme - accepts string name or path"""
     if isinstance(theme, str):
         if theme in themes:
@@ -32,77 +23,54 @@ def resolve_theme(theme):
         raise ValueError(f"Unknown theme: {theme}. Available: {list(themes.keys())}")
     return theme
 
-def function(python_version=None, pip=None, apt=None, run_commands=None, copy=None, name=None, base_url=None, key=None):
-    # """
-    # A decorator factory that transforms a Python function into a containerized,
-    # remotely executable object.
-    def decorator(func):
-        Name = name or func.__name__
-        copy_dict = {i:i for i in copy or []}
-        return Runtime(func, Name.replace('_', '-'), python_version, pip, apt, run_commands, copy_dict, base_url, key)
-    return decorator
+def _set_prod(config: Config, prod: bool):
+    config.prod = prod
+    config.pk = PK_LIVE if prod else PK_TEST
+    config.jwks = JWKS_PROD if prod else JWKS_TEST
+
+class AgentRuntime:
+    """Wraps an agent function with local/deploy/modal capabilities."""
+
+    def __init__(self, func, name, theme, pip, apt, copy, copy_public, modal_keys, auth, org, domain, header, intro, title, plan, analytics):
+        self.func = func
+        self.name = name
+        self.theme = _resolve_theme(theme)
+        self.pip = pip
+        self.apt = apt
+        self.copy = copy
+        self.copy_public = copy_public
+        self.modal_keys = modal_keys
+        self.domain = domain or f"{name}.cycls.ai"
+
+        self.config = Config(
+            header=header,
+            intro=intro,
+            title=title,
+            auth=auth,
+            plan=plan,
+            analytics=analytics,
+            org=org,
+        )
 
-class Agent:
-    def __init__(self, theme="default", org=None, api_token=None, pip=[], apt=[], copy=[], copy_public=[], modal_keys=["",""], key=None, base_url=None):
-        self.org, self.api_token = org, api_token
-        self.theme = resolve_theme(theme)
-        self.key, self.modal_keys, self.pip, self.apt, self.copy, self.copy_public = key, modal_keys, pip, apt, copy, copy_public
-        self.base_url = base_url
-
-        self.registered_functions = []
-
-    def __call__(self, name=None, header="", intro="", title="", domain=None, auth=False, tier="free", analytics=False):
-        if tier=="cycls_pass":
-            auth=True
-            analytics=True
-        def decorator(f):
-            agent_name = name or f.__name__.replace('_', '-')
-            self.registered_functions.append(RegisteredAgent(
-                func=f,
-                name=agent_name,
-                domain=domain or f"{agent_name}.cycls.ai",
-                config=Config(
-                    header=header,
-                    intro=intro,
-                    title=title,
-                    auth=auth,
-                    tier=tier,
-                    analytics=analytics,
-                    org=self.org,
-                ),
-            ))
-            return f
-        return decorator
+    def __call__(self, *args, **kwargs):
+        """Make the runtime callable - delegates to the wrapped function."""
+        return self.func(*args, **kwargs)
 
     def _local(self, port=8080, watch=True):
         """Run directly with uvicorn (no Docker)."""
-        if not self.registered_functions:
-            print("Error: No @agent decorated function found.")
-            return
-
-        agent = self.registered_functions[0]
-        if len(self.registered_functions) > 1:
-            print(f"⚠️  Warning: Multiple agents found. Running '{agent.name}'.")
-        print(f"🚀 Starting local server at localhost:{port}")
-        agent.config.public_path = self.theme
-        set_prod(agent.config, False)
-        uvicorn.run(web(agent.func, agent.config), host="0.0.0.0", port=port, reload=watch)
-        return
+        print(f"Starting local server at localhost:{port}")
+        self.config.public_path = self.theme
+        _set_prod(self.config, False)
+        uvicorn.run(web(self.func, self.config), host="0.0.0.0", port=port, reload=watch)
 
     def _runtime(self, prod=False):
-        """Create a Runtime instance for the first registered agent."""
-        if not self.registered_functions:
-            print("Error: No @agent decorated function found.")
-            return None
-
-        agent = self.registered_functions[0]
-        if len(self.registered_functions) > 1:
-            print(f"⚠️  Warning: Multiple agents found. Running '{agent.name}'.")
+        """Create a Runtime instance for deployment."""
+        _set_prod(self.config, prod)
+        config_dict = self.config.model_dump()
 
-        set_prod(agent.config, prod)
-        func = agent.func
-        name = agent.name
-        config_dict = agent.config.model_dump()
+        # Extract to local variables to avoid capturing self in lambda (cloudpickle issue)
+        func = self.func
+        name = self.name
 
         files = {str(self.theme): "theme", str(CYCLS_PATH)+"/web.py": "web.py"}
         files.update({f: f for f in self.copy})
@@ -114,73 +82,100 @@ class Agent:
             apt_packages=self.apt,
             pip_packages=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", *self.pip],
             copy=files,
-            base_url=self.base_url,
-            api_key=self.key
+            base_url=base_url,
+            api_key=api_key
         )
 
     def local(self, port=8080, watch=True):
         """Run locally in Docker with file watching by default."""
-        # Child process spawned by watcher - run without watch
         if os.environ.get('_CYCLS_WATCH_CHILD'):
             watch = False
         runtime = self._runtime(prod=False)
-        if runtime:
-            runtime.watch(port=port) if watch else runtime.run(port=port)
+        runtime.watch(port=port) if watch else runtime.run(port=port)
 
     def deploy(self, port=8080):
         """Deploy to production."""
-        if self.key is None:
-            print("🛑  Error: Please add your Cycls API key")
+        if api_key is None:
+            print("Error: Please set cycls.api_key")
             return
         runtime = self._runtime(prod=True)
-        if runtime:
-            runtime.deploy(port=port)
-        
+        runtime.deploy(port=port)
+
     def modal(self, prod=False):
         import modal
         from modal.runner import run_app
-        self.client = modal.Client.from_credentials(*self.modal_keys)
+
+        # Extract to local variables to avoid capturing self in lambda
+        func = self.func
+        name = self.name
+        domain = self.domain
+
+        client = modal.Client.from_credentials(*self.modal_keys)
         image = (modal.Image.debian_slim()
                             .pip_install("fastapi[standard]", "pyjwt", "cryptography", *self.pip)
                             .apt_install(*self.apt)
                             .add_local_dir(self.theme, "/root/theme")
                             .add_local_file(str(CYCLS_PATH)+"/web.py", "/root/web.py"))
-       
+
         for item in self.copy:
             image = image.add_local_file(item, f"/root/{item}") if "." in item else image.add_local_dir(item, f'/root/{item}')
-        
+
         for item in self.copy_public:
             image = image.add_local_file(item, f"/root/public/{item}") if "." in item else image.add_local_dir(item, f'/root/public/{item}')
 
-        self.app = modal.App("development", image=image)
-    
-        if not self.registered_functions:
-            print("Error: No @agent decorated function found.")
-            return
+        app = modal.App("development", image=image)
+
+        _set_prod(self.config, prod)
+        config_dict = self.config.model_dump()
+
+        app.function(serialized=True, name=name)(
+            modal.asgi_app(label=name, custom_domains=[domain])
+            (lambda: __import__("web").web(func, config_dict))
+        )
 
-        for agent in self.registered_functions:
-            set_prod(agent.config, prod)
-            func = agent.func
-            name = agent.name
-            domain = agent.domain
-            config_dict = agent.config.model_dump()
-            self.app.function(serialized=True, name=name)(
-                modal.asgi_app(label=name, custom_domains=[domain])
-                (lambda: __import__("web").web(func, config_dict))
-            )
         if prod:
-            for agent in self.registered_functions:
-                print(f"✅ Deployed to ⇒ https://{agent.domain}")
-            self.app.deploy(client=self.client, name=self.registered_functions[0].name)
-            return
+            print(f"Deployed to => https://{domain}")
+            app.deploy(client=client, name=name)
         else:
             with modal.enable_output():
-                run_app(app=self.app, client=self.client)
-                print(" Modal development server is running. Press Ctrl+C to stop.")
-                with modal.enable_output(), run_app(app=self.app, client=self.client):
+                run_app(app=app, client=client)
+                print("Modal development server is running. Press Ctrl+C to stop.")
+                with modal.enable_output(), run_app(app=app, client=client):
                     while True: time.sleep(10)
 
-# docker system prune -af
-# poetry config pypi-token.pypi <your-token>
-# poetry run python cake.py
-# poetry publish --build
+
+def agent(name=None, pip=[], apt=[], copy=[], copy_public=[], theme="default", modal_keys=["", ""], auth=False, org=None, domain=None, header="", intro="", title="", plan="free", analytics=False):
+    """Decorator that transforms a function into a deployable agent."""
+    if plan == "cycls_pass":
+        auth = True
+        analytics = True
+
+    def decorator(func):
+        agent_name = name or func.__name__.replace('_', '-')
+        return AgentRuntime(
+            func=func,
+            name=agent_name,
+            theme=theme,
+            pip=pip,
+            apt=apt,
+            copy=copy,
+            copy_public=copy_public,
+            modal_keys=modal_keys,
+            auth=auth,
+            org=org,
+            domain=domain,
+            header=header,
+            intro=intro,
+            title=title,
+            plan=plan,
+            analytics=analytics,
+        )
+    return decorator
+
+def function(python_version=None, pip=None, apt=None, run_commands=None, copy=None, name=None):
+    """Decorator that transforms a Python function into a containerized, remotely executable object."""
+    def decorator(func):
+        func_name = name or func.__name__
+        copy_dict = {i: i for i in copy or []}
+        return Runtime(func, func_name.replace('_', '-'), python_version, pip, apt, run_commands, copy_dict, base_url, api_key)
+    return decorator

cycls/web.py

@@ -10,7 +10,7 @@ class Config(BaseModel):
     title: str = ""
     prod: bool = False
     auth: bool = False
-    tier: str = "free"
+    plan: str = "free"
     analytics: bool = False
     org: Optional[str] = None
     pk: str = ""

{cycls-0.0.2.71.dist-info → cycls-0.0.2.73.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.71
+Version: 0.0.2.73
 Summary: Distribute Intelligence
 Author: Mohammed J. AlRujayi
 Author-email: mj@cycls.com
@@ -32,6 +32,7 @@ Distribute Intelligence
 
 <h4 align="center">
   <a href="https://pypi.python.org/pypi/cycls"><img src="https://img.shields.io/pypi/v/cycls.svg?label=cycls+pypi&color=blueviolet" alt="cycls Python package on PyPi" /></a>
+  <a href="https://github.com/Cycls/cycls/actions/workflows/tests.yml"><img src="https://github.com/Cycls/cycls/actions/workflows/tests.yml/badge.svg" alt="Tests" /></a>
   <a href="https://blog.cycls.com"><img src="https://img.shields.io/badge/newsletter-blueviolet.svg?logo=substack&label=cycls" alt="Cycls newsletter" /></a>
   <a href="https://x.com/cyclsai">
     <img src="https://img.shields.io/twitter/follow/CyclsAI" alt="Cycls Twitter" />
@@ -53,24 +54,27 @@ Write a function. Deploy it as an API, a web interface, or both. Add authenticat
 ```python
 import cycls
 
-agent = cycls.Agent(pip=["openai"])
+cycls.api_key = "YOUR_CYCLS_API_KEY"
 
-@agent("my-agent", auth=True, analytics=True)
-async def chat(context):
+@cycls.agent(pip=["openai"])
+async def agent(context):
     from openai import AsyncOpenAI
     client = AsyncOpenAI()
 
-    response = await client.chat.completions.create(
-        model="gpt-4o",
-        messages=context.messages,
-        stream=True
+    stream = await client.responses.create(
+        model="o3-mini",
+        input=context.messages,
+        stream=True,
+        reasoning={"effort": "medium", "summary": "auto"},
     )
 
-    async for chunk in response:
-        if chunk.choices[0].delta.content:
-            yield chunk.choices[0].delta.content
+    async for event in stream:
+        if event.type == "response.reasoning_summary_text.delta":
+            yield {"type": "thinking", "thinking": event.delta}  # Renders as thinking bubble
+        elif event.type == "response.output_text.delta":
+            yield event.delta
 
-agent.deploy()  # Live at https://my-agent.cycls.ai
+agent.deploy()  # Live at https://agent.cycls.ai
 ```
 
 ## Installation
@@ -87,7 +91,7 @@ Requires Docker.
 - **Web Interface** - Chat UI served automatically
 - **Authentication** - `auth=True` enables JWT-based access control
 - **Analytics** - `analytics=True` tracks usage
-- **Monetization** - `tier="cycls_pass"` integrates with [Cycls Pass](https://cycls.ai) subscriptions
+- **Monetization** - `plan="cycls_pass"` integrates with [Cycls Pass](https://cycls.ai) subscriptions
 - **Native UI Components** - Render thinking bubbles, tables, code blocks in responses
 
 ## Running
@@ -95,17 +99,33 @@ Requires Docker.
 ```python
 agent.local()             # Development with hot-reload (localhost:8080)
 agent.local(watch=False)  # Development without hot-reload
-agent.deploy()            # Production: https://agent-name.cycls.ai
+agent.deploy()            # Production: https://agent.cycls.ai
 ```
 
 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):
+    # context.user available when auth=True
+    user = context.user  # User(id, email, name, plans)
+    yield f"Hello {user.name}!"
+```
+
+| Flag | Description |
+|------|-------------|
+| `auth=True` | Universal user pool via Cycls Pass (Clerk-based). You can also use your own Clerk auth. |
+| `analytics=True` | Rich usage metrics available on the Cycls dashboard. |
+| `plan="cycls_pass"` | Monetization via Cycls Pass subscriptions. Enables both auth and analytics. |
+
 ## Native UI Components
 
 Yield structured objects for rich streaming responses:
 
 ```python
-@agent()
+@cycls.agent()
 async def demo(context):
     yield {"type": "thinking", "thinking": "Analyzing the request..."}
     yield "Here's what I found:\n\n"
@@ -128,32 +148,26 @@ async def demo(context):
 | `{"type": "callout", "callout": "...", "style": "..."}` | Yes |
 | `{"type": "image", "src": "..."}` | Yes |
 
-### Reasoning Models
+### Thinking Bubbles
 
-```python
-@agent()
-async def chat(context):
-    from openai import AsyncOpenAI
-    client = AsyncOpenAI()
+The `{"type": "thinking", "thinking": "..."}` component renders as a collapsible thinking bubble in the UI. Each yield appends to the same bubble until a different component type is yielded:
 
-    stream = await client.responses.create(
-        model="o3-mini",
-        input=context.messages,
-        stream=True,
-        reasoning={"effort": "medium", "summary": "auto"},
-    )
+```python
+# Multiple yields build one thinking bubble
+yield {"type": "thinking", "thinking": "Let me "}
+yield {"type": "thinking", "thinking": "analyze this..."}
+yield {"type": "thinking", "thinking": " Done thinking."}
 
-    async for event in stream:
-        if event.type == "response.reasoning_summary_text.delta":
-            yield {"type": "thinking", "thinking": event.delta}
-        elif event.type == "response.output_text.delta":
-            yield event.delta
+# Then output the response
+yield "Here's what I found..."
 ```
 
+This works seamlessly with OpenAI's reasoning models - just map reasoning summaries to the thinking component.
+
 ## Context Object
 
 ```python
-@agent()
+@cycls.agent()
 async def chat(context):
     context.messages      # [{"role": "user", "content": "..."}]
     context.messages.raw  # Full data including UI component parts
@@ -183,16 +197,17 @@ See [docs/streaming-protocol.md](docs/streaming-protocol.md) for frontend integr
 
 ## Declarative Infrastructure
 
-Define your entire runtime in Python:
+Define your entire runtime in the decorator:
 
 ```python
-agent = cycls.Agent(
+@cycls.agent(
     pip=["openai", "pandas", "numpy"],
     apt=["ffmpeg", "libmagic1"],
-    run_commands=["curl -sSL https://example.com/setup.sh | bash"],
     copy=["./utils.py", "./models/", "/absolute/path/to/config.json"],
     copy_public=["./assets/logo.png", "./static/"],
 )
+async def my_agent(context):
+    ...
 ```
 
 ### `pip` - Python Packages
@@ -211,17 +226,6 @@ Install system-level dependencies via apt-get. Need ffmpeg for audio processing?
 apt=["ffmpeg", "imagemagick", "libpq-dev"]
 ```
 
-### `run_commands` - Shell Commands
-
-Run arbitrary shell commands during the container build. Useful for custom setup scripts, downloading assets, or any build-time configuration.
-
-```python
-run_commands=[
-    "curl -sSL https://example.com/setup.sh | bash",
-    "chmod +x /app/scripts/*.sh"
-]
-```
-
 ### `copy` - Bundle Files and Directories
 
 Include local files and directories in your container. Works with both relative and absolute paths. Copies files and entire directory trees.
@@ -237,7 +241,7 @@ copy=[
 Then import them in your function:
 
 ```python
-@agent()
+@cycls.agent(copy=["./utils.py"])
 async def chat(context):
     from utils import helper_function  # Your bundled module
     ...

{cycls-0.0.2.71.dist-info → cycls-0.0.2.73.dist-info}/RECORD

@@ -1,14 +1,14 @@
-cycls/__init__.py,sha256=bVT0dYTXLdSC3ZURgtm-DEOj-VO6RUM6zGsJB0zuj6Y,61
+cycls/__init__.py,sha256=HEpBZpHkC-4YwDUqcKAcnulyPxcvKnplhx91nB2a7IU,464
 cycls/auth.py,sha256=xkndHZyCfnlertMMEKerCJjf23N3fVcTRVTTSXTTuzg,247
 cycls/cli.py,sha256=AKf0z7ZLau3GvBVR_IhB7agmq4nVaHkcuUafNyvv2_A,7978
 cycls/default-theme/assets/index-B0ZKcm_V.css,sha256=wK9-NhEB8xPcN9Zv69zpOcfGTlFbMwyC9WqTmSKUaKw,6546
 cycls/default-theme/assets/index-D5EDcI4J.js,sha256=sN4qRcAXa7DBd9JzmVcCoCwH4l8cNCM-U9QGUjBvWSo,1346506
 cycls/default-theme/index.html,sha256=bM-yW_g0cGrV40Q5yY3ccY0fM4zI1Wuu5I8EtGFJIxs,828
 cycls/dev-theme/index.html,sha256=QJBHkdNuMMiwQU7o8dN8__8YQeQB45D37D-NCXIWB2Q,11585
-cycls/runtime.py,sha256=LgOrQ6Arh-GWSJqckfra-CvjeSekTvGvjHOBxu7JTQQ,21408
-cycls/sdk.py,sha256=6oRKP44TJN9HKdNw9OYzDlZFDUMUhoCMt8TEwyu26dI,7368
-cycls/web.py,sha256=3M3qaWTNY3dpgd7Vq5aXREp-cIFsHrDqBQ1YkGrOaUk,4659
-cycls-0.0.2.71.dist-info/METADATA,sha256=MG66f3JLtPXNMLV1rCs29BYkBxk2B3aMIG5_azsD9HI,8008
-cycls-0.0.2.71.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-cycls-0.0.2.71.dist-info/entry_points.txt,sha256=vEhqUxFhhuzCKWtq02LbMnT3wpUqdfgcM3Yh-jjXom8,40
-cycls-0.0.2.71.dist-info/RECORD,,
+cycls/runtime.py,sha256=lg7XKHd9fLV_bYksHv2LHf3Lq7HPAC3K5Tr8pNgQ7sM,21641
+cycls/sdk.py,sha256=X8-VAVqtksO0VGJIxlg02HLmeFpwtwMHWu9PNksS5kw,6620
+cycls/web.py,sha256=_QNH8K55vTm90Z7tvcRKal5IybjkB1GY7Pf9p3qu3r8,4659
+cycls-0.0.2.73.dist-info/METADATA,sha256=IP8h-NzyerOy701pjRYDbY_Nbvb1WsoU6JTKYE8xQ34,8695
+cycls-0.0.2.73.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+cycls-0.0.2.73.dist-info/entry_points.txt,sha256=vEhqUxFhhuzCKWtq02LbMnT3wpUqdfgcM3Yh-jjXom8,40
+cycls-0.0.2.73.dist-info/RECORD,,