cycls 0.0.2.83__tar.gz → 0.0.2.84__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cycls
-Version: 0.0.2.83
+Version: 0.0.2.84
 Summary: Distribute Intelligence
 Author: Mohammed J. AlRujayi
 Author-email: mj@cycls.com
@@ -12,12 +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: httpx (>=0.27.0,<0.28.0)
-Requires-Dist: modal (>=1.1.0,<2.0.0) ; extra == "modal"
 Requires-Dist: pyjwt (>=2.8.0,<3.0.0)
 Description-Content-Type: text/markdown
 
@@ -47,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.
@@ -56,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()
 
@@ -74,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
@@ -97,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).
@@ -107,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}!"
@@ -125,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"
@@ -167,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
@@ -200,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):
     ...
 ```
 
@@ -241,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
     ...
@@ -255,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.83 → 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

cycls-0.0.2.83/cycls/runtime.py → cycls-0.0.2.84/cycls/function.py

@@ -16,14 +16,12 @@ BASE_IMAGE = "ghcr.io/cycls/base:python3.12"
 BASE_PACKAGES = {"cloudpickle", "cryptography", "fastapi", "fastapi[standard]",
                  "pydantic", "pyjwt", "uvicorn", "uvicorn[standard]", "httpx"}
 
-# Entrypoint for deployed services - loads pickled function+args and runs it
 ENTRYPOINT_PY = '''import cloudpickle
 with open("/app/function.pkl", "rb") as f:
     func, args, kwargs = cloudpickle.load(f)
 func(*args, **kwargs)
 '''
 
-# Runner script for local dev - reads pickle from volume, writes result back
 RUNNER_PY = '''import cloudpickle
 import sys
 import traceback
@@ -44,6 +42,15 @@ except Exception:
     sys.exit(1)
 '''
 
+# Module-level configuration
+api_key = None
+base_url = None
+
+def _get_api_key():
+    return api_key or os.getenv("CYCLS_API_KEY")
+
+def _get_base_url():
+    return base_url or os.getenv("CYCLS_BASE_URL")
 
 def _hash_path(path_str: str) -> str:
     h = hashlib.sha256()
@@ -73,35 +80,34 @@ def _copy_path(src_path: Path, dest_path: Path):
         shutil.copy(src_path, dest_path)
 
 
-class Runtime:
-    """Executes functions in Docker containers. Uses file-based pickle for communication."""
+class Function:
+    """Executes functions in Docker containers."""
 
-    def __init__(self, func, name, python_version=None, pip_packages=None, apt_packages=None,
+    def __init__(self, func, name, python_version=None, pip=None, apt=None,
                  run_commands=None, copy=None, base_url=None, api_key=None, base_image=None):
         self.func = func
-        self.name = name
+        self.name = name.replace('_', '-')
         self.python_version = python_version or f"{sys.version_info.major}.{sys.version_info.minor}"
-        self.apt_packages = sorted(apt_packages or [])
+        self.apt = sorted(apt or [])
         self.run_commands = sorted(run_commands or [])
-        self.copy = copy or {}
+        self.copy = {f: f for f in copy} if isinstance(copy, list) else (copy or {})
         self.base_image = base_image or BASE_IMAGE
         self.base_url = base_url or "https://service-core-280879789566.me-central1.run.app"
         self.api_key = api_key
 
-        user_packages = set(pip_packages or [])
+        user_packages = set(pip or [])
         if self.base_image == BASE_IMAGE:
-            self.pip_packages = sorted(user_packages - BASE_PACKAGES)
+            self.pip = sorted(user_packages - BASE_PACKAGES)
         else:
-            self.pip_packages = sorted(user_packages | {"cloudpickle"})
+            self.pip = sorted(user_packages | {"cloudpickle"})
 
-        self.image_prefix = f"cycls/{name}"
-        self.managed_label = "cycls.runtime"
+        self.image_prefix = f"cycls/{self.name}"
+        self.managed_label = "cycls.function"
         self._docker_client = None
         self._container = None
 
     @property
     def docker_client(self):
-        """Lazily initializes and returns a Docker client."""
         if self._docker_client is None:
             try:
                 print("Initializing Docker client...")
@@ -115,7 +121,6 @@ class Runtime:
         return self._docker_client
 
     def _perform_auto_cleanup(self, keep_tag=None):
-        """Clean up old containers and dev images (preserve deploy-* images)."""
         try:
             current_id = self._container.id if self._container else None
             for container in self.docker_client.containers.list(all=True, filters={"label": self.managed_label}):
@@ -135,9 +140,8 @@ class Runtime:
             print(f"Warning: cleanup error: {e}")
 
     def _image_tag(self, extra_parts=None) -> str:
-        """Creates a unique tag based on image configuration."""
-        parts = [self.base_image, self.python_version, "".join(self.pip_packages),
-                 "".join(self.apt_packages), "".join(self.run_commands)]
+        parts = [self.base_image, self.python_version, "".join(self.pip),
+                 "".join(self.apt), "".join(self.run_commands)]
         for src, dst in sorted(self.copy.items()):
             if not Path(src).exists():
                 raise FileNotFoundError(f"Path in 'copy' not found: {src}")
@@ -147,18 +151,17 @@ class Runtime:
         return f"{self.image_prefix}:{hashlib.sha256(''.join(parts).encode()).hexdigest()[:16]}"
 
     def _dockerfile_preamble(self) -> str:
-        """Common Dockerfile setup: base image, apt, pip, run commands, copy."""
         lines = [f"FROM {self.base_image}"]
 
         if self.base_image != BASE_IMAGE:
             lines.append("ENV PIP_ROOT_USER_ACTION=ignore PYTHONUNBUFFERED=1")
             lines.append("WORKDIR /app")
 
-        if self.apt_packages:
-            lines.append(f"RUN apt-get update && apt-get install -y --no-install-recommends {' '.join(self.apt_packages)}")
+        if self.apt:
+            lines.append(f"RUN apt-get update && apt-get install -y --no-install-recommends {' '.join(self.apt)}")
 
-        if self.pip_packages:
-            lines.append(f"RUN uv pip install --system --no-cache {' '.join(self.pip_packages)}")
+        if self.pip:
+            lines.append(f"RUN uv pip install --system --no-cache {' '.join(self.pip)}")
 
         for cmd in self.run_commands:
             lines.append(f"RUN {cmd}")
@@ -169,14 +172,12 @@ class Runtime:
         return "\n".join(lines)
 
     def _dockerfile_local(self) -> str:
-        """Dockerfile for local dev: runner script with volume mount."""
         return f"""{self._dockerfile_preamble()}
 COPY runner.py /app/runner.py
 ENTRYPOINT ["python", "/app/runner.py", "/io"]
 """
 
     def _dockerfile_deploy(self, port: int) -> str:
-        """Dockerfile for deploy: baked-in function via pickle."""
         return f"""{self._dockerfile_preamble()}
 COPY function.pkl /app/function.pkl
 COPY entrypoint.py /app/entrypoint.py
@@ -185,14 +186,12 @@ CMD ["python", "entrypoint.py"]
 """
 
     def _copy_user_files(self, workdir: Path):
-        """Copy user-specified files to build context."""
         context_files_dir = workdir / "context_files"
         context_files_dir.mkdir()
         for src, dst in self.copy.items():
             _copy_path(Path(src).resolve(), context_files_dir / dst)
 
     def _build_image(self, tag: str, workdir: Path) -> str:
-        """Build a Docker image from a prepared context."""
         print("--- Docker Build Logs ---")
         try:
             for chunk in self.docker_client.api.build(
@@ -209,7 +208,6 @@ CMD ["python", "entrypoint.py"]
             raise
 
     def _ensure_local_image(self) -> str:
-        """Build local dev image if needed."""
         tag = self._image_tag(extra_parts=["local-v1"])
         try:
             self.docker_client.images.get(tag)
@@ -226,8 +224,7 @@ CMD ["python", "entrypoint.py"]
             return self._build_image(tag, workdir)
 
     def _cleanup_container(self):
-        """Stop and remove the container."""
-        if self._container:
+        if getattr(self, '_container', None):
             try:
                 self._container.stop(timeout=3)
                 self._container.remove()
@@ -239,7 +236,6 @@ CMD ["python", "entrypoint.py"]
 
     @contextlib.contextmanager
     def runner(self, *args, **kwargs):
-        """Context manager for running a function in a container."""
         service_port = kwargs.get('port')
         tag = self._ensure_local_image()
         self._perform_auto_cleanup(keep_tag=tag)
@@ -267,7 +263,6 @@ CMD ["python", "entrypoint.py"]
                 self._cleanup_container()
 
     def run(self, *args, **kwargs):
-        """Execute the function in a container and return the result."""
         service_port = kwargs.get('port')
         print(f"Running '{self.name}'...")
 
@@ -284,7 +279,7 @@ CMD ["python", "entrypoint.py"]
                     return None
 
                 if service_port:
-                    return None  # Service mode, no result
+                    return None
 
                 if result_path.exists():
                     with open(result_path, 'rb') as f:
@@ -302,7 +297,6 @@ CMD ["python", "entrypoint.py"]
             return None
 
     def watch(self, *args, **kwargs):
-        """Run with file watching - restarts on changes."""
         if os.environ.get('_CYCLS_WATCH'):
             return self.run(*args, **kwargs)
 
@@ -335,7 +329,6 @@ CMD ["python", "entrypoint.py"]
                 return
 
     def _prepare_deploy_context(self, workdir: Path, port: int, args=(), kwargs=None):
-        """Prepare build context for deploy: pickle function+args + entrypoint."""
         kwargs = kwargs or {}
         kwargs['port'] = port
         self._copy_user_files(workdir)
@@ -345,7 +338,6 @@ CMD ["python", "entrypoint.py"]
             cloudpickle.dump((self.func, args, kwargs), f)
 
     def build(self, *args, **kwargs):
-        """Build a deployable Docker image locally."""
         port = kwargs.pop('port', 8080)
         payload = cloudpickle.dumps((self.func, args, {**kwargs, 'port': port}))
         tag = f"{self.image_prefix}:deploy-{hashlib.sha256(payload).hexdigest()[:16]}"
@@ -365,7 +357,6 @@ CMD ["python", "entrypoint.py"]
             return tag
 
     def deploy(self, *args, **kwargs):
-        """Deploy the function to a remote build server."""
         import requests
 
         port = kwargs.pop('port', 8080)
@@ -411,5 +402,11 @@ CMD ["python", "entrypoint.py"]
                 return None
 
     def __del__(self):
-        """Cleanup on garbage collection."""
         self._cleanup_container()
+
+
+def function(name=None, **kwargs):
+    """Decorator that transforms a Python function into a containerized Function."""
+    def decorator(func):
+        return Function(func, name or func.__name__, **kwargs, base_url=_get_base_url(), api_key=_get_api_key())
+    return decorator

{cycls-0.0.2.83 → cycls-0.0.2.84}/cycls/web.py

@@ -2,19 +2,25 @@ import json, inspect
 from pathlib import Path
 from pydantic import BaseModel
 from typing import Optional
+from .auth import PK_LIVE, PK_TEST, JWKS_PROD, JWKS_TEST
 
 class Config(BaseModel):
     public_path: str = "theme"
-    header: str = ""
-    intro: str = ""
-    title: str = ""
+    header: Optional[str] = None
+    intro: Optional[str] = None
+    title: Optional[str] = None
     prod: bool = False
     auth: bool = False
     plan: str = "free"
     analytics: bool = False
     org: Optional[str] = None
-    pk: str = ""
-    jwks: str = ""
+    pk: Optional[str] = None
+    jwks: Optional[str] = None
+
+    def set_prod(self, prod: bool):
+        self.prod = prod
+        self.pk = PK_LIVE if prod else PK_TEST
+        self.jwks = JWKS_PROD if prod else JWKS_TEST
 
 async def openai_encoder(stream):
     if inspect.isasyncgen(stream):

{cycls-0.0.2.83 → cycls-0.0.2.84}/pyproject.toml

@@ -1,9 +1,9 @@
 [tool.poetry]
 name = "cycls"
-version = "0.0.2.83"
+version = "0.0.2.84"
 
 packages = [{ include = "cycls" }]
-include = ["cycls/theme/**/*"]
+include = ["cycls/themes/**/*"]
 description = "Distribute Intelligence"
 authors = ["Mohammed J. AlRujayi <mj@cycls.com>"]
 readme = "README.md"
@@ -17,7 +17,7 @@ docker = "^7.1.0"
 cloudpickle = "^3.1.1"
 
 [tool.poetry.scripts]
-cycls = "cycls.chat:main"
+cycls = "cycls.cli:main"
 
 [tool.poetry.group.test.dependencies]
 pytest = "^8.0.0"
@@ -27,13 +27,6 @@ requests = "^2.31.0"
 [tool.poetry.group.dev.dependencies]
 grpcio-tools = "^1.76.0"
 
-[tool.poetry.extras]
-modal = ["modal"]
-
-[tool.poetry.dependencies.modal]
-version = "^1.1.0"
-optional = true
-
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"

cycls-0.0.2.83/cycls/__init__.py

@@ -1,20 +0,0 @@
-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.83/cycls/sdk.py

@@ -1,186 +0,0 @@
-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):
-        """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)
-
-    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'):
-            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:
-            raise RuntimeError("Missing API key. Set cycls.api_key before calling deploy().")
-        runtime = self._runtime(prod=True)
-        return 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=None, apt=None, copy=None, copy_public=None, theme="default", modal_keys=None, auth=False, org=None, domain=None, header="", intro="", title="", plan="free", analytics=False):
-    """Decorator that transforms a function into a deployable agent."""
-    pip = pip or []
-    apt = apt or []
-    copy = copy or []
-    copy_public = copy_public or []
-    modal_keys = modal_keys or ["", ""]
-
-    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