cycls 0.0.2.72__tar.gz → 0.0.2.74__tar.gz

{cycls-0.0.2.72 → cycls-0.0.2.74}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.72
+Version: 0.0.2.74
 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" />
@@ -46,31 +47,32 @@ The open-source SDK for distributing AI agents.
 
 ## Distribute Intelligence
 
-AI capabilities shouldn't be locked in notebooks or trapped behind months of infrastructure work. Cycls turns your Python functions into production services - complete with APIs, interfaces, auth, and analytics. You focus on the intelligence. Cycls handles the distribution.
-
 Write a function. Deploy it as an API, a web interface, or both. Add authentication, analytics, and monetization with flags.
 
 ```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 +89,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 +97,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 +146,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 +195,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 +224,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 +239,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.72 → cycls-0.0.2.74}/README.md

@@ -9,6 +9,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" />
@@ -23,31 +24,32 @@ The open-source SDK for distributing AI agents.
 
 ## Distribute Intelligence
 
-AI capabilities shouldn't be locked in notebooks or trapped behind months of infrastructure work. Cycls turns your Python functions into production services - complete with APIs, interfaces, auth, and analytics. You focus on the intelligence. Cycls handles the distribution.
-
 Write a function. Deploy it as an API, a web interface, or both. Add authentication, analytics, and monetization with flags.
 
 ```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
@@ -64,7 +66,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
@@ -72,17 +74,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"
@@ -105,32 +123,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
@@ -160,16 +172,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
@@ -188,17 +201,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.
@@ -214,7 +216,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.74/cycls/__init__.py

@@ -0,0 +1,20 @@
+import sys
+from types import ModuleType
+from .sdk import function, agent
+from .runtime import Runtime
+
+class _Module(ModuleType):
+    def __getattr__(self, 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__(self, name, value):
+        from . import sdk
+        if name in ("api_key", "base_url"):
+            setattr(sdk, name, value)
+            return
+        super().__setattr__(name, value)
+
+sys.modules[__name__].__class__ = _Module

cycls-0.0.2.74/cycls/sdk.py

@@ -0,0 +1,181 @@
+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
+
+CYCLS_PATH = importlib.resources.files('cycls')
+
+# 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):
+    """Resolve theme - accepts string name or path"""
+    if isinstance(theme, str):
+        if theme in themes:
+            return themes[theme]
+        raise ValueError(f"Unknown theme: {theme}. Available: {list(themes.keys())}")
+    return theme
+
+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,
+        )
+
+    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)."""
+        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 deployment."""
+        _set_prod(self.config, prod)
+        config_dict = self.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})
+        files.update({f: f"public/{f}" for f in self.copy_public})
+
+        return Runtime(
+            func=lambda port: __import__("web").serve(func, config_dict, name, port),
+            name=name,
+            apt_packages=self.apt,
+            pip_packages=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", *self.pip],
+            copy=files,
+            base_url=base_url,
+            api_key=api_key
+        )
+
+    def local(self, port=8080, watch=True):
+        """Run locally in Docker with file watching by default."""
+        if os.environ.get('_CYCLS_WATCH_CHILD'):
+            watch = False
+        runtime = self._runtime(prod=False)
+        runtime.watch(port=port) if watch else runtime.run(port=port)
+
+    def deploy(self, port=8080):
+        """Deploy to production."""
+        if api_key is None:
+            print("Error: Please set cycls.api_key")
+            return
+        runtime = self._runtime(prod=True)
+        runtime.deploy(port=port)
+
+    def modal(self, prod=False):
+        import modal
+        from modal.runner import run_app
+
+        # 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}')
+
+        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))
+        )
+
+        if prod:
+            print(f"Deployed to => https://{domain}")
+            app.deploy(client=client, name=name)
+        else:
+            with modal.enable_output():
+                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)
+
+
+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-0.0.2.72 → cycls-0.0.2.74}/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.72 → cycls-0.0.2.74}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "cycls"
-version = "0.0.2.72"
+version = "0.0.2.74"
 
 packages = [{ include = "cycls" }]
 include = ["cycls/theme/**/*"]
@@ -19,6 +19,10 @@ cloudpickle = "^3.1.1"
 [tool.poetry.scripts]
 cycls = "cycls.cli:main"
 
+[tool.poetry.group.test.dependencies]
+pytest = "^8.0.0"
+requests = "^2.31.0"
+
 [tool.poetry.extras]
 modal = ["modal"]
 

cycls-0.0.2.72/cycls/__init__.py

@@ -1,2 +0,0 @@
-from .sdk import Agent, function
-from .runtime import Runtime

cycls-0.0.2.72/cycls/sdk.py

@@ -1,186 +0,0 @@
-import os, time, inspect, 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
-
-themes = {
-    "default": CYCLS_PATH.joinpath('default-theme'),
-    "dev": CYCLS_PATH.joinpath('dev-theme'),
-}
-
-def resolve_theme(theme):
-    """Resolve theme - accepts string name or path"""
-    if isinstance(theme, str):
-        if theme in themes:
-            return themes[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
-
-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 _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
-
-    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}'.")
-
-        set_prod(agent.config, prod)
-        func = agent.func
-        name = agent.name
-        config_dict = agent.config.model_dump()
-
-        files = {str(self.theme): "theme", str(CYCLS_PATH)+"/web.py": "web.py"}
-        files.update({f: f for f in self.copy})
-        files.update({f: f"public/{f}" for f in self.copy_public})
-
-        return Runtime(
-            func=lambda port: __import__("web").serve(func, config_dict, name, port),
-            name=name,
-            apt_packages=self.apt,
-            pip_packages=["fastapi[standard]", "pyjwt", "cryptography", "uvicorn", *self.pip],
-            copy=files,
-            base_url=self.base_url,
-            api_key=self.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)
-
-    def deploy(self, port=8080):
-        """Deploy to production."""
-        if self.key is None:
-            print("🛑  Error: Please add your Cycls API key")
-            return
-        runtime = self._runtime(prod=True)
-        if runtime:
-            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)
-        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
-
-        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
-        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):
-                    while True: time.sleep(10)
-
-# docker system prune -af
-# poetry config pypi-token.pypi <your-token>
-# poetry run python cake.py
-# poetry publish --build